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 que se va 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; las rutas intermedias 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 utilizando la función ftp_connect(). Aquí tienes 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 comunes incluyen permisos insuficientes, una ruta inválida o que el directorio de destino ya exista. Ten en cuenta que ftp_mkdir() fallará si el directorio especificado ya existe.

Aquí tienes 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 configurar 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() proporciona una manera sencilla de crear directorios en un servidor FTP. Recuerda validar tu conexión, manejar los errores de manera adecuada, configurar tiempos de espera apropiados y crear 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.

Práctica

¿Cuál es la función principal de ftp_mkdir() en PHP?

Ayuda a crear un directorio en el servidor FTP.Ayuda a eliminar un directorio del servidor FTP.Es útil para renombrar archivos en el servidor FTP.Es útil para transferir archivos desde el sistema local al servidor FTP.