(PHP 4, PHP 5, PHP 7)
mkdir — Crée un dossier
$pathname
[, int $mode
= 0777
[, bool $recursive
= FALSE
[, resource $context
]]] )Tente de créer un dossier.
pathname
Le chemin du dossier.
mode
Le mode par défaut est le mode 0777, ce qui correspond au maximum de droits possible. Pour plus d'informations sur les modes, lisez en détail la documentation de la fonction chmod().
Note:
mode
est ignoré sous Windows.
Notez que vous aurez à préciser le mode en base octale, ce qui signifie que vous aurez probablement un 0 comme premier chiffre. Le mode sera aussi modifié par le umask courant, que vous pouvez modifier avec la fonction umask().
recursive
Permet la création de répertoires imbriqués spécifiés dans le
pathname
.
context
Note: Le support de contexte a été ajouté en PHP 5.0.0. Pour une description des contextes, référez-vous à Flux.
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Exemple #1 Exemple avec mkdir()
<?php
mkdir("/path/to/my/dir", 0700);
?>
Exemple #2 mkdir() utilisant le paramètre recursive
<?php
// Structure de répertoire désirée
$structure = './depth1/depth2/depth3/';
// Pour créer une stucture imbriquée, le paramètre $recursive
// doit être spécifié.
if (!mkdir($structure, 0777, true)) {
die('Echec lors de la création des répertoires...');
}
// ...
?>
Emet une alerte de niveau E_WARNING
si le dossier
existe déjà.
Emet une alerte de niveau E_WARNING
si les permissions
empéchent la création du dossier.
Note: Lorsque le safe-mode est activé, PHP vérifie si le fichier/dossier que vous allez utiliser a le même UID que le script qui est actuellement exécuté.