php-homepage.de - Die deutschsprachige Ressource für PHP und MySQL- Manual

Beschreibung

bool mkdir ( string $pathname [, int $mode = 0777 [, bool $recursive = false [, resource $context ]]] )

Versucht ein Verzeichnis mit dem angegebenen Namen zu erstellen.

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. Standardmäßig FALSE.

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.

Changelog

Version	Beschreibung
5.0.0	Der `recursive`-Parameter wurde hinzugefügt.
5.0.0	Seit PHP 5.0.0 kann mkdir() auch mit einigen URL-Wrappern genutzt werden. In der Unterstützte Protokolle and Wrappers finden Sie eine Liste aller Wrapper, die mkdir() unterstützen.
4.2.0	Der `mode`-Parameter wurde optional.

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, 0, true)) {
    die('Erstellung der Verzeichnisse schlug fehl...');
}

// ...
?>

Anmerkungen

Hinweis: Wenn Safe Mode aktiviert ist überprüft PHP, ob das Arbeitsverzeichnis, die gleiche UID (Eigentümer) hat wie das Skript selbst.

Siehe auch

is_dir() - Prüft, ob der angegebene Dateiname ein Verzeichnis ist
rmdir() - Löscht ein Verzeichnis