(PHP 4, PHP 5, PHP 7)
mkdir — Erstellt ein Verzeichnis
$pathname
[, int $mode
= 0777
[, bool $recursive
= FALSE
[, resource $context
]]] ) : boolVersucht ein Verzeichnis mit dem angegebenen Namen zu erstellen.
pathname
Der Verzeichnispfad.
mode
Der Modus ist standardmäßig 0777, was den größtmöglichen Zugang umfasst. Für weitere Informationen lesen Sie bitte die Details auf der chmod()-Seite.
Hinweis:
mode
wird unter Windows ignoriert.
Beachten Sie, dass Sie den Modus als oktalen Wert angeben sollten, d.h., dass er eine führende Null haben sollte. Der Modus wird auch durch die aktuelle umask geändert, die Sie mit umask() ändern können.
recursive
Erlaubt die Erstellung von im pathname
angegebenen
verschachtelten Verzeichnissen.
context
Hinweis: Die Kontext-Unterstützung gibt es seit PHP 5.0.0. Eine Beschreibung von
Kontexten
finden Sie unter Streams.
Gibt bei Erfolg TRUE
zurück. Im Fehlerfall wird FALSE
zurückgegeben.
Beispiel #1 mkdir()-Beispiel
<?php
mkdir("/path/to/my/dir", 0700);
?>
Beispiel #2 mkdir() mit dem recursive
-Parameter benutzen
<?php
// Gewünschte Verzeichnisstruktur
$structure = './stufe1/stufe2/stufe3/';
// Zur Erstellung der verschachtelten Struktur muss der $recursive-Parameter
// von mkdir() angegeben werden
if (!mkdir($structure, 0777, true)) {
die('Erstellung der Verzeichnisse schlug fehl...');
}
// ...
?>
Erzeugt einen Fehler der Stufe E_WARNING
, falls das
Verzeichnis bereits existiert.
Erzeugt einen Fehler der Stufe E_WARNING
, wenn die
relevanten Zugriffsrechte das Erstellen des Verzeichnisses verhindern.