mkdir

(PHP 4, PHP 5, PHP 7, PHP 8)

mkdirCrea una directory

Descrizione

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

Tenta di creare la directory specificata da pathname.

Elenco dei parametri

pathname

Il percorso della directory.

mode

Il parametro mode viene impostato a 0777 per default, ciò significa dare i maggiori accessi possibili. Per ulteriori informazioni sui valori di mode, leggere i dettagli sulla pagina di chmod().

Nota:

mode viene ignorato su Windows.

Nota che probabilmente si vuole specificare mode come un ottale, per cui deve iniziare con uno zero. La modalità è anche modificata dall'umask corrente, che può essere cambiato usando umask().

recursive

Consente la creazione di directory nidificate specificate in pathname.

context

Nota: Il supporto per il contesto è stato aggiunto in PHP 5.0.0. Per la descrizione del contesto, fare riferimento a Stream Funzioni.

Valori restituiti

Restituisce true in caso di successo, false in caso di fallimento.

Esempi

Example #1 Esempio di mkdir()

<?php
mkdir
("/path/to/my/dir", 0700);
?>

Example #2 mkdir() usando il parametro recursive

<?php
// Struttura delle cartelle desiderata
$structure = './depth1/depth2/depth3/';

// Per creare la struttura nidificata, deve essere specificato
// il parametro $recursive nella mkdir()

if (!mkdir($structure, 0777, true)) {
die(
'Failed to create folders...');
}

// ...
?>

Errori/Eccezioni

Emette un errore di livello E_WARNING se la directory esiste già.

Emette un errore di livello E_WARNING se le autorizzazioni pertinenti impediscono la creazione della directory.

Vedere anche:

  • is_dir() - Dice se la stringa corrisponde ad una directory
  • rmdir() - Rimuove una directory