Saltar al contenido

realpath()

Introducción

En PHP, la función realpath() resuelve la ruta absoluta de un archivo o directorio. Es particularmente útil para normalizar rutas y resolver enlaces simbólicos. Este artículo cubre su sintaxis, comportamiento y ejemplos prácticos.

Comprender la función realpath()

La función realpath() toma una cadena de ruta y devuelve la ruta absoluta canónica. Resuelve automáticamente los segmentos . y .., elimina las barras finales y sigue los enlaces simbólicos hasta sus destinos reales. Si la ruta especificada no existe o no se puede resolver, la función devuelve false.

Sintaxis de la función realpath()

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

php
realpath($path);

Aquí, $path es la ruta al archivo o directorio. La función devuelve la ruta absoluta resuelta como una cadena, o false en caso de error.

Ejemplos de uso de realpath()

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

Ejemplo 1: Resolver la ruta absoluta de un archivo

php
<?php

$file_path = 'example.txt';
$absolute_path = realpath($file_path);

if ($absolute_path !== false) {
    echo $absolute_path;
} else {
    echo "File not found.";
}

Este ejemplo resuelve la ruta absoluta del archivo example.txt y maneja de forma segura los casos en los que el archivo no existe.

Ejemplo 2: Resolver la ruta absoluta de un directorio

php
<?php

$dir_path = 'example_directory';
$absolute_path = realpath($dir_path);

if ($absolute_path !== false) {
    echo $absolute_path;
} else {
    echo "Directory not found.";
}

En este ejemplo, se resuelve la ruta absoluta del directorio example_directory utilizando realpath() e incluye un manejo básico de errores para directorios faltantes.

Conclusión

La función realpath() es una herramienta confiable para normalizar rutas y resolver enlaces simbólicos en PHP. Al verificar si devuelve false, puedes asegurarte de que tus scripts manejen archivos o directorios faltantes de manera elegante. Úsala para construir una gestión de rutas más robusta en tus proyectos.

Práctica

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

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