(PHP 4, PHP 5)
mkdir — Crée un dossier
$pathname
[, int $mode = 0777
[, bool $recursive = false
[, resource $context
]]] )Tente de créer un dossier.
pathnameLe chemin du dossier.
modeLe 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:
modeest 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.
contextNote: 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.
| Version | Description |
|---|---|
| 5.0.0 |
Le paramètre recursive a été ajouté
|
| 5.0.0 | Depuis PHP 5.0.0, la fonction mkdir() peut aussi être utilisée avec certains gestionnaires d'URL. Reportez-vous à Liste des protocoles et des gestionnaires supportés, pour une liste des gestionnaires qui supportent mkdir(). |
| 4.2.0 |
Le paramètre mode est devenu optionnel.
|
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é.