Funciones del Sistema de Archivos
PHP Manual

mkdir

(PHP 4, PHP 5)

mkdirCrea un directorio

Descripción

bool mkdir ( string $pathname [, int $mode = 0777 [, bool $recursive = false [, resource $context ]]] )

Intenta crear el directorio especificado por pathname.

Parámetros

pathname

La ruta del directorio.

mode

El modo predeterminado es 0777, lo que significa el acceso más amplio posible. Para más información sobre los modos, lea los detalles en la página de chmod().

Nota:

mode es ignorado en Windows.

Observe que probablemente se quiera especificar el modo como un número octal, lo que significa que debería de haber un cero inicial. El modo es modificado también por la actual máscara de usuario, la cual se puede cambiar usando umask().

recursive

Permite la creación de directorios anidados especificado en el parámetro pathname.

context

Nota: Soporte para context fue añadido en PHP 5.0.0. Para una descripción de contexts, refiérase a Flujos.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Historial de cambios

Versión Descripción
5.0.0 Se añadio el parámetro recursive
5.0.0 A partir de PHP 5.0.0 mkdir() también se puede usar con algunas envolturas de URL. Consulte Protocolos y Envolturas soportados para una lista de las envolturas admitidas por mkdir()
4.2.0 Ahora, el parámetro mode es opcional.

Ejemplos

Ejemplo #1 Ejmplo de mkdir()

<?php
mkdir
("/ruta/a/mi/directorio"0700);
?>

Ejemplo #2 mkdir() usando el parámetro recursive

<?php
// Estructura de la carpeta deseada
$estructura './nivel1/nivel2/nivel3/';

// Para crear una estructura anidada se debe especificar
// el parámetro $recursive en mkdir().

if(!mkdir($estructura0777true)) {
    die(
'Fallo al crear las carpetas...');
}

// ...
?>

Errores/Excepciones

Emite un error de nivel E_WARNING si el directorio ya existe.

Emite un error de nivel E_WARNING si los permisos relevantes impiden crear el directorio.

Notas

Nota: Cuando safe mode está habilitado, PHP comprueba si el directorio en el que el script está operando tiene el mismo UID (propietario) que el script que está siendo ejecutado.

Ver también


Funciones del Sistema de Archivos
PHP Manual