Saltar al contenido

mkdir()

¿Qué es la función mkdir()?

La función mkdir() es una función integrada de PHP que crea un nuevo directorio. Esta función toma tres parámetros: la ruta del directorio, un modo de permisos opcional y una bandera booleana para crear directorios anidados de forma recursiva.

A continuación se muestra la sintaxis básica de la función mkdir():

La sintaxis de PHP de mkdir()

php
mkdir(string $dirname, int $permissions = 0777, bool $recursive = false): bool

Donde $dirname es la ruta del directorio que desea crear, $permissions es un modo octal opcional que especifica los permisos para el nuevo directorio y $recursive es un booleano opcional que permite la creación de directorios anidados.

¿Cómo usar la función mkdir()?

Usar la función mkdir() es sencillo. Siga estos pasos:

  1. Especifique la ruta del directorio que desea crear.
  2. Llame a la función mkdir(), pasando la ruta del directorio como primer parámetro, un modo de permisos opcional como segundo parámetro y una bandera booleana como tercer parámetro para crear directorios padre si es necesario.

A continuación se muestra un fragmento de código de ejemplo que demuestra cómo usar la función mkdir():

¿Cómo usar la función mkdir()?

php
<?php

$dir = '/path/to/new/directory';
// 0755 is recommended for security (owner: rwx, others: rx)
$permissions = 0755;
if (!is_dir($dir)) {
    if (mkdir($dir, $permissions, true)) {
        echo "Directory created successfully!";
    } else {
        echo "Failed to create directory.";
    }
} else {
    echo "Directory already exists!";
}

En este ejemplo, usamos is_dir() para verificar con precisión si el destino es un directorio. Especificamos un modo de permisos más seguro (0755) y pasamos true como tercer argumento para habilitar la creación recursiva. La función mkdir() devuelve un valor booleano, por lo que envolvemos la llamada en una sentencia if para manejar el éxito o el fallo de manera adecuada. Si el directorio no existe, intentamos crearlo e imprimimos un mensaje de éxito o fallo. Si ya existe, imprimimos un mensaje indicando que ya existe.

Conclusión

La función mkdir() es una herramienta útil en PHP para crear nuevos directorios en un sistema de archivos. Siguiendo los pasos descritos en esta guía, puede usar fácilmente la función mkdir() en sus proyectos PHP para crear nuevos directorios con permisos específicos y un manejo de errores adecuado. Esperamos que esta guía haya sido útil.

Práctica

¿Qué hace la función mkdir de PHP?

¿Te resulta útil?

Vista previa dual-run — compárala con las rutas Symfony en producción.