mkdir
(PHP 4, PHP 5, PHP 7, PHP 8)
mkdir — Erstellt ein Verzeichnis
Beschreibung
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:
permissionswird unter Windows ignoriert.Beachten Sie, dass Sie
permissionsals oktalen Wert angeben sollten, d. h., dass er eine führende Null haben sollte.permissionswird auch durch das aktuelle umask verändert, das Sie mit umask() ändern können. -
recursive -
Falls
true, werden auch die übergeordneten Verzeichnisse des angegebenendirectoryerstellt, 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
falsezurü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...');
}
// ...
?>
