ftp_mkdir()

¿Qué es ftp_mkdir()?

La función ftp_mkdir() es una función integrada de PHP que crea un nuevo directorio en el servidor FTP. La función acepta dos parámetros:

1. ftp_stream: El identificador de conexión devuelto por la función ftp_connect().
2. directory: El nombre del directorio a crear.

La función devuelve true si el directorio se creó correctamente. De lo contrario, devuelve false. Ten en cuenta que ftp_mkdir() no puede crear directorios anidados; los directorios intermedios deben crearse manualmente.

Sintaxis de ftp_mkdir()

La sintaxis de la función ftp_mkdir() es la siguiente:

Sintaxis de ftp_mkdir()

bool ftp_mkdir ( FTP\Connection $ftp_stream , string $directory )

Nota: La firma tipada anterior requiere PHP 8.0+. La función está disponible desde PHP 4.3.0.

Uso de ftp_mkdir()

Para usar la función ftp_mkdir(), primero debes establecer una conexión con el servidor FTP mediante la función ftp_connect() y autenticarte con ftp_login(). A continuación se muestra un ejemplo:

Uso de ftp_mkdir()

<?php

// Set up an FTP connection
$conn = ftp_connect('ftp.example.com');

// Login with your FTP credentials
ftp_login($conn, 'username', 'password');

// Create a new directory
if (ftp_mkdir($conn, '/path/to/new/directory')) {
    echo "Directory created successfully.\n";
} else {
    echo "Failed to create directory.\n";
}

// Close the FTP connection
ftp_close($conn);

En este ejemplo, establecemos una conexión con el servidor FTP mediante la función ftp_connect(). Luego iniciamos sesión con nuestras credenciales FTP usando la función ftp_login(). Finalmente, creamos un nuevo directorio con la función ftp_mkdir() y cerramos la conexión FTP.

Manejo de errores en ftp_mkdir()

Es importante manejar los errores correctamente al usar la función ftp_mkdir(). Si la función devuelve false, significa que la creación del directorio no fue exitosa. Las razones más comunes incluyen permisos insuficientes, una ruta no válida o que el directorio de destino ya exista. Ten en cuenta que ftp_mkdir() fallará si el directorio especificado ya existe.

A continuación se muestra un ejemplo de cómo manejar errores y configurar ajustes FTP confiables:

Manejo de errores en ftp_mkdir()

<?php
if (ftp_mkdir($conn, '/path/to/new/directory')) {
    echo "Directory created successfully.\n";
} else {
    echo "Failed to create directory.\n";
    // Note: PHP's FTP extension does not expose the last server response directly.
    // Verify connection status, permissions, and path validity.
}
?>

Para operaciones FTP confiables, considera establecer un tiempo de espera y habilitar el modo pasivo antes de crear directorios:

ftp_set_option($conn, FTP_TIMEOUT_SEC, 30);
ftp_set_option($conn, FTP_USEPASVADDRESS, true);

Conclusión

La función ftp_mkdir() ofrece una manera sencilla de crear directorios en un servidor FTP. Recuerda validar tu conexión, manejar los errores de forma elegante, establecer tiempos de espera adecuados y crear los directorios intermedios manualmente cuando sea necesario. Aplicar estas prácticas te ayudará a integrar la gestión de directorios FTP en tus aplicaciones PHP de forma confiable.

Funciones relacionadas

Estas funciones se usan habitualmente junto con ftp_mkdir() al gestionar directorios a través de FTP:

• ftp_rmdir() — elimina un directorio del servidor FTP.
• ftp_chdir() — cambia el directorio de trabajo actual en el servidor.
• ftp_pwd() — devuelve la ruta del directorio actual.
• ftp_set_option() — configura opciones como el tiempo de espera de la conexión.
• ftp_pasv() — activa o desactiva el modo pasivo, frecuentemente necesario detrás de cortafuegos.
• ftp_close() — cierra la conexión FTP cuando hayas terminado.

Práctica