Есть ли руководство по ссылкам на пути в PHP?

вероятно, проще использовать абсолютный путь для ссылки:

set_include_path('/path/to/files');

таким образом, у вас есть ориентир для всего вашего будущего. include обрабатываются относительно точки, в которой они были вызваны, что может вызвать некоторую путаницу в определенных сценариях.

в качестве примера, учитывая образец структуры папок (/home/files):

index.php
test/
  test.php
test2/
  test2.php

// /home/files/index.php
include('test/test.php');

// /home/files/test/test.php
include('../test2/test2.php');

если вы вызовете index.php, он попытается включить следующие файлы:

/home/files/test/test.php // expected
/home/test2/test2.php // maybe not expected

что может быть не тем, что вы ожидаете. вызов test.php вызовет /home/files/test2/test.php, как и ожидалось.

в заключение, включение будет относиться к исходной точке вызова. Чтобы уточнить, это влияет на set_include_path(), если он также относительный. рассмотрите следующее (используя ту же структуру каталогов):

<?php
// location: /home/files/index.php
   set_include_path('../'); // our include path is now /home/

   include('files/test/test.php'); // try to include /home/files/test/test.php
   include('test2/test2.php'); // try to include /home/test2/test2.php
   include('../test3.php'); // try to include /test3.php
?>

Я обычно использую dirname для получения текущего пути, а затем использую его как основу для вычисления всех будущих имен путей.

Например,

$base = dirname( __FILE__ ); # Path to directory containing this file
include( "{$base}/includes/Common.php" ); # Kick off some magic