Fonctions sur les systèmes de fichiers
PHP Manual

mkdir

(PHP 4, PHP 5)

mkdirCrée un dossier

Description

bool mkdir ( string $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($structure0777true)) {
    die(
'Echec lors de la création des répertoires...');
}

// ...
?>

Erreurs / Exceptions

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.

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é.

Voir aussi


Fonctions sur les systèmes de fichiers
PHP Manual