array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.mkdir.php', 1 => 'mkdir', 2 => 'Erstellt ein Verzeichnis', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Dateisystem', ), 'prev' => array ( 0 => 'function.lstat.php', 1 => 'lstat', ), 'next' => array ( 0 => 'function.move-uploaded-file.php', 1 => 'move_uploaded_file', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/filesystem/functions/mkdir.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mkdir

(PHP 4, PHP 5, PHP 7, PHP 8)

mkdir — Erstellt ein Verzeichnis

Beschreibung

mkdir(
    string $directory,
    int $permissions = 0777,
    bool $recursive = false,
    ?resource $context = null
): bool

Versucht, das durch directory angegebene Verzeichnis zu erstellen.

Parameter-Liste

directory

Der Verzeichnispfad.

permissions

Der Zugriffsberechtigungen sind standardmäßig 0777, was den größtmöglichen Zugang umfasst. Für weitere Informationen lesen Sie bitte die Details auf der chmod()-Seite.

Hinweis:

permissions wird unter Windows ignoriert.

Beachten Sie, dass Sie permissions als oktalen Wert angeben sollten, d. h., dass er eine führende Null haben sollte. permissions wird auch durch das aktuelle umask verändert, das Sie mit umask() ändern können.

recursive

Falls true, werden auch die übergeordneten Verzeichnisse des angegebenen directory erstellt, wobei die gleichen Zugriffsrechte gelten.

context

Eine Stream-Kontext-Ressource.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Hinweis:

Wenn das zu erstellende Verzeichnis bereits existiert, wird dies als Fehler angesehen und es wird false zurückgegeben. Bevor versucht wird, ein Verzeichnis zu erstellen, sollte mit is_dir() oder file_exists() geprüft werden, ob es bereits existiert.

Fehler/Exceptions

Gibt einen Fehler der Stufe E_WARNING aus, falls das Verzeichnis bereits existiert.

Gibt einen Fehler der Stufe E_WARNING aus, falls die zugehörigen Berechtigungen verhindern, dass das Verzeichnis erstellt wird.

Beispiele

Beispiel #1 mkdir()-Beispiel

<?php
mkdir("/path/to/my/dir", 0700);
?>

Beispiel #2 mkdir() mit dem Parameter recursive benutzen

<?php
// Gewünschte Verzeichnisstruktur
$structure = './stufe1/stufe2/stufe3/';

// Zur Erstellung der verschachtelten Struktur muss der Parameter $recursive
// von mkdir() angegeben werden

if (!mkdir($structure, 0777, true)) {
die('Erstellung der Verzeichnisse schlug fehl...');
}

// ...
?>

Siehe auch