mkdir
Erstellt ein Verzeichnis
Beschreibung
bool mkdir
( string $pathname
[, int $mode = 0777
[, bool $recursive = false
[, resource $context
]]] )
Parameter-Liste
-
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.
Rückgabewerte
Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.
Beispiele
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...');
}
// ...
?>
Fehler/Exceptions
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.
Anmerkungen
Hinweis: Wenn Safe Mode aktiviert ist überprüft PHP, ob
das Arbeitsverzeichnis, die gleiche UID (Eigentümer) hat wie das Skript
selbst.