PHP | Función mkdir()

mkdir() crea un nuevo directorio con el nombre de ruta especificado. La ruta y el modo se envían como parámetros a la función mkdir() y devuelve VERDADERO en caso de éxito o FALSO en caso de falla.
El parámetro de modo en la función mkdir() se ignora en las plataformas Windows.

Sintaxis:

mkdir(path, mode, recursive, context)

Parámetros usados:
La función mkdir() en PHP acepta cuatro parámetros.

1. ruta: Es un parámetro obligatorio que especifica la ruta.
2. modo: es un parámetro opcional que especifica el permiso.
   El parámetro de modo consta de cuatro números:
   • El primer número siempre es cero.
   • El segundo número especifica los permisos para el propietario.
   • El tercer número especifica los permisos para el grupo de usuarios del propietario.
   • El cuarto número especifica permisos para todos los demás.

   El conjunto de valores posibles son:

   • 1 = permisos de ejecución
   • 2 = permisos de escritura
   • 4 = permisos de lectura

   Se pueden configurar múltiples permisos sumando los siguientes números.

3. recursivo: es un parámetro opcional que se puede utilizar para establecer el modo recursivo.
4. contexto: es un parámetro opcional que especifica el comportamiento de la secuencia.

Valor devuelto:
Devuelve VERDADERO en caso de éxito o FALSO en caso de fallo.

Errores y excepciones:

1. El parámetro de modo en la función mkdir() debe especificarse en representación octal, por lo que debe comenzar con un cero.
2. Se genera un error de nivel E_WARNING si el directorio ya existe.
3. Se genera un error de nivel E_WARNING si los permisos relevantes impiden la creación del directorio.

Ejemplos:

Input : mkdir("/documents/gfg/articles/");
Output : 1

Input : mkdir("/documents/gfg/articles/", 0770)
Output : 1

Input : $nest = './node1/node2/node3/';
        if (!mkdir($nest, 0777, true)) 
        {
          echo('Folders cannot be created recursively');
        }
        else
        {
          echo('Folders created recursively');
        }

Output : Folders created recursively

Los siguientes programas ilustran la función mkdir().

Programa 1

<?php 
// making a directory with default mode i.e 0777
mkdir("/documents/gfg/articles/");
?>

Producción:

1

Programa 2

<?php 
// making a directory with the provision of all
// permissions to the owner and the owner's user group
mkdir("/documents/gfg/articles/", 0770)
?>

Producción:

1

Programa 3

<?php 
$nest = './node1/node2/node3/';
// creating a nested structure directory
if (!mkdir($nest, 0777, true)) 
  {
     echo('Folders cannot be created recursively');
  }
else
  {
     echo('Folders created recursively');
  }
?>

Producción:

Folders created recursively

Artículo relacionado: PHP | Función rmdir( )

Referencia:
http://php.net/manual/en/function.mkdir.php