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

    • is_dir() - Prüft, ob der angegebene Dateiname ein Verzeichnis ist
    • rmdir() - Löscht ein Verzeichnis
    • umask() - Changes the current umask
    To Top