Documentación offline PHP master

realpath

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

realpath

Retorna la ruta de acceso canónica absoluta

Descripción#

realpath(string $path): string
```php

`realpath` resuelve todos los enlaces simbólicos, y reemplaza todas las referencias `/./`, `/../` y `/` de `path` luego retorna la ruta de acceso canónica absoluta así encontrada.

## Parámetros

`path`  
La ruta de acceso a verificar.

> [!NOTE]
> Debe ser proporcionada una ruta de acceso, el valor puede ser una cadena de caracteres vacía. En estos casos, el valor es interpretado como el directorio actual.

## Valores devueltos

Retorna la ruta de acceso canónica absoluta así encontrada. El resultado no contiene ningún enlace simbólico, `/./` o `/../`. Los delimitadores de fin como `\` y `/` son igualmente eliminados.

`realpath` retorna `false` si ocurre un error, por ejemplo si el fichero no existe.

> [!NOTE]
> El script que se ejecuta debe tener los permisos de ejecución sobre todos los directorios de la estructura, de lo contrario, la función `realpath` retornará `false`.

> [!NOTE]
> Para los sistemas de archivos insensibles a mayúsculas/minúsculas, `realpath` puede o no normalizar la casilla de los caracteres.

> [!NOTE]
> La función `realpath` no funcionará para un fichero que se encuentra dentro de un phar ya que esta ruta sería una ruta de acceso virtual, no una real.

> [!NOTE]
> En Windows, las uniones y los enlaces simbólicos a los directorios son únicamente extendidos a un nivel.

> [!NOTE]
> Como el tipo entero de PHP es firmado y que muchas plataformas utilizan enteros de 32 bits, algunas funciones relacionadas con el sistema de archivos pueden retornar resultados extraños para ficheros de tamaño superior a 2 Go.

## Ejemplos

Ejemplo con `realpath`
El ejemplo anterior mostrará:

    /etc/passwd
    /tmp

Ejemplo con `realpath` en Windows

En Windows, `realpath` cambiará las rutas de estilo Unix a rutas de estilo Windows.

```php

El ejemplo anterior mostrará:

C:\WINDOWS\System32
C:\Program Files

Véase también#

basename, dirname, pathinfo