Ruta del directorio superior en PHP

La path del directorio padre de un script puede servir para muchas cosas. En mi caso lo uso para definir algunas constantes como la path base, la ruta de los assets y esas cosas.

Esto es importante cuando tenemos un archivo que se encarga de cargar a los demás, por ejemplo un autoload o un index.php en donde exponemos nuestra API.

En fin, veremos cómo obtener la ruta del directorio padre que tiene el script.

Usar dirname para obtener directorio padre

La función que usaremos será dirname. Me parece que dirname toma una ruta y te devuelve la ruta de un directorio arriba.

Gracias a las constantes mágicas como __FILE__ que dan el nombre del script, y __DIR__ que dan el nombre del directorio en donde se ejecuta el script podemos usar dirname en conjunto con ellos para determinar la ruta de un directorio arriba.

Podemos probar con este script:

<?php
 
echo "\nEste script se ejecuta en: " . __DIR__;
$padre = dirname(__DIR__);
echo "\nLa ruta del padre es: $padre";

La salida al menos en mi caso es:

Este script se ejecuta en: D:\desarrollo\ejercicios
La ruta del padre es: D:\desarrollo

Lo importante que debemos notar es que sí funciona, pues de ejercicios vamos a un directorio arriba. Con eso podemos obtener la ruta del padre y de ahí bajar hacia otra carpeta.

Más directorios hacia arriba

Podemos llamar a dirname múltiples veces para seguir subiendo. Veamos este ejemplo:

<?php
 
echo "\nEste script se ejecuta en: " . __DIR__;
$padre = dirname(__DIR__);
echo "\nLa ruta del padre es: $padre";
$masArriba = dirname($padre);
echo "\nUna ruta más arriba es: $masArriba";

Como vemos subimos 2 directorios arriba llamando a dirname con el resultado anterior. La salida es:

Este script se ejecuta en: D:\desarrollo\ejercicios
La ruta del padre es: D:\desarrollo
Una ruta más arriba es: D:\

Por cierto, si llegamos a la raíz ya no podremos seguir subiendo (obviamente) y dirname regresará la ruta de la raíz.

Otra opción (que recomiendo) para subir múltiples directorios es mandar el segundo argumento indicando los niveles. Es decir, en vez de llamar muchas veces a dirname llámalo una vez con el número de directorios que quieres subir:

dirname(__DIR__, 2);

Referencias

Constantes mágicas en PHP, como __FILE__ y __DIR__

Documentación de dirname