mkdir
(PHP 4, PHP 5)
mkdir — Crée un dossier
Description
$pathname
[, int $mode
= 0777
[, bool $recursive
= false
[, resource $context
]]] )Tente de créer un dossier.
Liste de paramètres
-
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.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Historique
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.
|
Exemples
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...');
}
// ...
?>
Notes
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é.