ftp_exec()

Comprender la función de PHP ftp_exec()

Este tutorial explica la función histórica ftp_exec(), por qué fue eliminada y cómo ejecutar comandos remotos de forma segura en PHP moderno.

¿Qué es ftp_exec()?

La función ftp_exec() era una función integrada de PHP que permitía ejecutar un comando en un servidor FTP remoto. Anteriormente aceptaba dos parámetros:

1. ftp_stream: El identificador de conexión devuelto por la función ftp_connect().
2. command: El comando que desea ejecutar en el servidor FTP.

La función devolvía un valor booleano. Si la función ejecutaba el comando con éxito, devolvía true. De lo contrario, devolvía false.

Importante: ftp_exec() dependía de que el servidor FTP admitiera el comando SITE EXECUTE. Debido a graves riesgos de seguridad, esta función se desactivó de forma predeterminada en la mayoría de los servidores FTP modernos (como vsftpd y ProFTPD). Más importante aún, ftp_exec() fue marcada como obsoleta en PHP 5.3.0 y eliminada en PHP 7.0.0, lo que la hace completamente inaccesible en versiones modernas de PHP.

Sintaxis de ftp_exec()

La sintaxis histórica de la función ftp_exec() era la siguiente:

Sintaxis de ftp_exec()

bool ftp_exec ( resource $ftp_stream , string $command )

(Nota: Esta función aceptaba históricamente un identificador de conexión de tipo resource. La clase OOP FTP\Connection se introdujo en PHP 8.0, después de que ftp_exec() ya hubiera sido eliminada.)

Ejecución Segura de Comandos Remotos

Dado que ftp_exec() ha sido eliminada y FTP carece de ejecución segura de comandos, en su lugar deberías utilizar bibliotecas basadas en SSH. La extensión ssh2 o phpseclib son los enfoques estándar para PHP moderno.

Uso con la extensión ssh2

<‌?php

// Set up an SSH connection
$conn = ssh2_connect('ftp.example.com', 22);
if (!$conn) {
    die("Could not connect to server.");
}

// Login with SSH credentials
if (!ssh2_auth_password($conn, 'username', 'password')) {
    die("SSH login failed.");
}

// Execute a command
$stream = ssh2_exec($conn, 'ls -al');
if ($stream === false) {
    die("Failed to execute command.");
}

// Read output
$output = stream_get_contents($stream);

// Close the connection
ssh2_disconnect($conn);

En este ejemplo, establecemos una conexión SSH mediante la función ssh2_connect(). Luego autenticamos usando ssh2_auth_password(). Finalmente, ejecutamos un comando con ssh2_exec() y cerramos la conexión con ssh2_disconnect().

Manejo de errores en la ejecución remota moderna

Es importante manejar los errores correctamente al ejecutar comandos remotos. Si la función devuelve false, significa que el comando no pudo ejecutarse por alguna razón. Aquí tienes un ejemplo de cómo manejar los errores:

Manejo de errores en ssh2_exec()

<‌?php

$stream = ssh2_exec($conn, 'ls -al');
if ($stream === false) {
    echo "Failed to execute the command.\n";
} else {
    echo "Command executed successfully.\n";
}

En este ejemplo, verificamos el valor de retorno de la función ssh2_exec(). Si es false, mostramos un mensaje de error; de lo contrario, mostramos un mensaje de éxito.

Conclusión

La función ftp_exec() fue marcada como obsoleta en PHP 5.3.0 y eliminada en PHP 7.0.0 debido a vulnerabilidades de seguridad y a la falta de ejecución segura de comandos a través de FTP. Para la ejecución de comandos remotos en PHP moderno, utiliza siempre soluciones basadas en SSH como la extensión ssh2 o phpseclib.

Práctica

¿Cuál es el propósito del comando exec de FTP en PHP?

Permite ejecutar un programa en el servidor FTP.Se utiliza para establecer una conexión con el servidor FTP.Se utiliza para cerrar una conexión con el servidor FTP.Envía un comando sin procesar al servidor FTP.Se utiliza para cargar archivos al servidor FTP.Permite controlar servidores FTP a través de PHP.