Saltar al contenido

ftp_rename()

Comprender la función PHP ftp_rename()

La función ftp_rename() es una función integrada de PHP que cambia el nombre de un archivo o directorio en un servidor FTP. En este artículo, discutiremos la función en detalle y te proporcionaremos una guía completa para usarla en tus proyectos PHP.

¿Qué es ftp_rename()?

La función ftp_rename() es una función integrada de PHP que cambia el nombre de un archivo o directorio en un servidor FTP. La función toma tres parámetros:

  1. ftp_stream: El identificador de conexión devuelto por la función ftp_connect().
  2. oldname: El nombre actual del archivo o directorio que se va a renombrar.
  3. newname: El nuevo nombre que se le asignará al archivo o directorio.

La función devuelve true en caso de éxito y false en caso de fallo.

Sintaxis de ftp_rename()

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

Sintaxis de ftp_rename()

php
bool ftp_rename ( resource $ftp_stream , string $oldname , string $newname )

La función ftp_rename() toma tres parámetros obligatorios: ftp_stream, oldname y newname. El parámetro ftp_stream es el identificador de conexión devuelto por la función ftp_connect(), oldname es el nombre actual del archivo o directorio que se va a renombrar, y newname es el nuevo nombre que se le asignará al archivo o directorio.

Uso de ftp_rename()

Para usar la función ftp_rename(), primero debes establecer una conexión con el servidor FTP utilizando la función ftp_connect(). Aquí tienes un ejemplo:

Uso de ftp_rename()

php
<?php

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

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

// Rename the file or directory
if (ftp_rename($conn, '/public_html/oldname.txt', '/public_html/newname.txt')) {
    echo "File renamed successfully.\n";
} else {
    echo "File rename failed.\n";
}

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

En este ejemplo, establecemos una conexión con el servidor FTP usando la función ftp_connect(). Luego, iniciamos sesión con nuestras credenciales FTP usando la función ftp_login(). Cambiamos el nombre del archivo o directorio usando la función ftp_rename() y mostramos un mensaje que indica si la operación fue exitosa. Finalmente, cerramos la conexión FTP usando la función ftp_close().

Manejo de errores en ftp_rename()

Es importante manejar los errores correctamente al usar la función ftp_rename(). Si la función devuelve false, significa que la operación no fue exitosa. Aquí tienes un ejemplo de cómo manejar los errores:

Manejo de errores en ftp_rename()

php
<?php

if (!ftp_rename($conn, '/public_html/oldname.txt', '/public_html/newname.txt')) {
    echo "Failed to rename file.\n";
}

ftp_close($conn);

Al manejar los errores de manera adecuada y verificar el valor de retorno de la función, puedes garantizar el éxito de tus operaciones FTP usando la función ftp_rename().

Conclusión

En conclusión, la función ftp_rename() es una herramienta útil para cambiar el nombre de archivos o directorios en un servidor FTP. Con un uso adecuado y un manejo de errores apropiado, esta función puede ser un activo valioso en tus proyectos PHP.

Práctica

¿Cuál es la función de 'ftp_rename' en PHP?

¿Te resulta útil?

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