(PHP 4, PHP 5)
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:
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.
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.
| 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, 0, true)) {
die('Echec lors de la création des répertoires...');
}
// ...
?>
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é.