¿PHP incluye rutas relativas al archivo o al código de llamada?

Tengo problemas para comprender el conjunto de reglas con respecto a las rutas de inclusión relativas de PHP. Si ejecuto el archivo A.PHP- y el archivo A.PHP incluye el archivo B.PHP que incluye el archivo C.PHP, si la ruta relativa a C.PHP está relacionada con la ubicación de B.PHP o con la ubicación de A .PHP? Es decir, ¿importa desde qué archivo se llama la inclusión, o solo cuál es el directorio de trabajo actual y qué determina el directorio de trabajo actual?

Es relativo al script principal, en este caso A.php. Recuerde que include()solo inserta código en el script que se está ejecutando actualmente.

Es decir, ¿importa desde qué archivo se llama la inclusión?

No.

Si desea que sea ​​importante y hacer una inclusión relativa a B.php, use la __FILE__constante (o __DIR__desde PHP 5.2 IIRC) que siempre apuntará al archivo actual literal en el que se encuentra la línea de código.

include(dirname(__FILE__)."/C.PHP");

@Pekka me llevó allí, pero solo quiero compartir lo que aprendí:

getcwd() devuelve el directorio donde reside el archivo que comenzó a ejecutar.

dirname(__FILE__) devuelve el directorio del archivo que contiene el código que se está ejecutando actualmente.

Con estas dos funciones, siempre puede crear una ruta de inclusión relativa a lo que necesita.

por ejemplo, si b.php y c.php comparten un directorio, b.php puede incluir c.php como:

include(dirname(__FILE__).'/c.php');

sin importar desde dónde se haya llamado a b.php.

De hecho, esta es la forma preferida de establecer rutas relativas, ya que el código adicional libera a PHP de tener que iterar a través de include_path en el intento de localizar el archivo de destino.

Fuentes:

¿Diferencia entre getcwd () y dirname (__ FILE__)? ¿Qué debo usar?

Por qué debería usar dirname (__ FILE__)

1. Si la ruta de inclusión no comienza con ./o ../, por ejemplo:

   include 'C.php'; // precedence: include_path (which include '.' at first),
                    // then path of current `.php` file (i.e. `B.php`), then `.`.

2. Si la ruta de inclusión comienza con ./o ../, por ejemplo:

   include './C.php';  // relative to '.'
   
   include '../C.php'; // also relative to '.'

El .o ..superior es relativo a getcwd(), que por defecto es la ruta del .phparchivo de entrada (es decir A.php).

Probado en PHP 5.4.3 (Fecha de compilación: 8 de mayo de 2012 00:47:34).

(También tenga en cuenta que chdir()puede cambiar la salida de getcwd()).

La respuesta aceptada de Pekka es incompleta y, en un contexto general, engañosa. Si el archivo se proporciona como una ruta relativa, la construcción del lenguaje llamado includelo buscará de la siguiente manera.

Primero, pasará por las rutas de la variable de entorno include_path, que se puede configurar con ini_set. Si esto falla, buscará en el directorio del script de llamada dirname(__FILE__)( __DIR__con php> = 5.3.) Si esto también falla, ¡solo entonces buscará en el directorio de trabajo! Resulta que, de forma predeterminada, la variable de entorno include_pathcomienza con ., que es el directorio de trabajo actual. Esa es la única razón por la que busca primero en el directorio de trabajo actual. Consulte http://php.net/manual/en/function.include.php .

Los archivos se incluyen en función de la ruta del archivo proporcionada o, si no se proporciona, la ruta_incluida especificada. Si el archivo no se encuentra en include_path, include finalmente verificará el directorio propio del script de llamada y el directorio de trabajo actual antes de fallar.

Entonces, la respuesta correcta a la primera parte de la pregunta es que sí importa dónde se encuentra el script de llamada incluido. La respuesta a la última parte de la pregunta es que el directorio de trabajo inicial , en un contexto de servidor web, es el directorio del script llamado, el script que incluye todos los demás mientras es manejado por PHP. En un contexto de línea de comandos, el directorio de trabajo inicial es lo que sea cuando se invoca php en el indicador, no necesariamente el directorio donde se encuentra el script llamado. El actual directorio de trabajo, sin embargo, se puede cambiar en tiempo de ejecución con la función de PHP chdir. Consulte http://php.net/manual/en/function.chdir.php .

Este párrafo se agrega para comentar otras respuestas. Algunos han mencionado que confiar en include_pathes menos robusto y, por lo tanto, es preferible utilizar rutas completas como ./patho __DIR__ . /path. Algunos fueron tan lejos como para decir que confiar en el directorio de trabajo en .sí no es seguro, porque se puede cambiar. Sin embargo, algunas veces, debe confiar en los valores del entorno. Por ejemplo, es posible que desee establecerlo include_pathvacío, de modo que el directorio del script de llamada sea el primer lugar en el que buscará, incluso antes del directorio de trabajo actual. Es posible que el código ya esté escrito y actualizado periódicamente desde fuentes externas y no desea volver a insertar el prefijo __DIR__cada vez que se actualice el código.

Respuesta corta: es relativa al guión incluido.

TFM lo explica correctamente:

Si el archivo no se encuentra en include_path, include verificará el directorio del script de llamada y el directorio de trabajo actual

Entonces, si /app/main.php dice include("./inc.php")que encontrará /app/inc.php .

El ./ no es estrictamente necesario, pero elimina cualquier dependencia de include_path.

No confiaría en encontrar archivos de inclusión en el directorio de trabajo actual en caso de que alguien lo cambie con chdir().

dir
-> a.php
-> c.php

- dir2 
-> b.php

Para incluir aen blo que necesitainclude("../a.php");

Para incluir ben clo que necesitainclude("dir2/b.php");