Saltar al contenido

rename()

Introducción

En PHP, la función rename() se utiliza para renombrar o mover un archivo o directorio. Es una función útil para gestionar archivos y directorios en tus scripts de PHP. En este artículo, cubriremos todo lo que necesitas saber sobre la función rename(), incluyendo su sintaxis, parámetros y ejemplos de cómo puede ser utilizada.

Comprender la función rename()

La función rename() en PHP se utiliza para renombrar o mover un archivo o directorio. Toma dos parámetros: el nombre o ruta actual del archivo o directorio, y el nuevo nombre o la ruta de destino completa.

Cuando utilizas rename(), PHP renombra o mueve el archivo o directorio a la nueva ubicación. Esto puede ser útil para gestionar archivos y directorios en tus scripts de PHP. Ten en cuenta que mover un archivo entre diferentes sistemas de archivos puede no estar soportado en todas las plataformas, y el proceso del servidor web debe tener permisos de lectura/escritura tanto para las rutas de origen como de destino.

Sintaxis de la función rename()

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

php
rename($old_name, $new_name);

Aquí, $old_name es el nombre o ruta actual del archivo o directorio, y $new_name es el nuevo nombre o la ruta de destino completa. La función devuelve true en caso de éxito y false en caso de fallo.

Ejemplos de uso de rename()

Veamos algunos ejemplos de cómo se puede utilizar la función rename() en PHP.

Ejemplo 1: Renombrar un archivo

php
if (rename('example.txt', 'new_example.txt')) {
    echo "File renamed successfully.";
} else {
    echo "Failed to rename the file.";
}

Este ejemplo renombra el archivo example.txt a new_example.txt.

Ejemplo 2: Mover un archivo

php
if (rename('example.txt', 'example_directory/example.txt')) {
    echo "File moved successfully.";
} else {
    echo "Failed to move the file.";
}

En este ejemplo, el archivo example.txt se mueve al directorio example_directory.

Conclusión

La función rename() en PHP es una función útil para gestionar archivos y directorios en tus scripts de PHP. Esperamos que este artículo te haya brindado una mejor comprensión de cómo funciona rename() y cómo puede ser utilizada en tus propios proyectos.

Práctica

¿Qué hace la función rename() en PHP?

¿Te resulta útil?

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