Способы извлечения путей в PHP: от файла до корня сайта

Расширенные примеры и редкие случаи

Разрешение символических ссылок с помощью realpath

Функция realpath() преобразует путь с симлинками и относительными сегментами в абсолютный канонический путь.

<?php
$path = __DIR__ . '/../config/db.php';
$canonical = realpath($path);
if ($canonical) {
    echo $canonical;
} else {
    echo 'Ошибка: путь не существует';
}
?>

/var/www/site/config/db.php

В случае, если симлинк ведёт на другую файловую систему, realpath() всё равно вернёт реальный путь.

Получение относительного пути от корня документа

Часто требуется преобразовать абсолютный путь скрипта в относительный URL. Это можно сделать, если известен $_SERVER['DOCUMENT_ROOT'].

<?php
$abs = __DIR__ . '/assets/image.jpg';
$docRoot = $_SERVER['DOCUMENT_ROOT'];
// Убираем корень документа из начала пути
if (strpos($abs, $docRoot) === 0) {
    $relative = substr($abs, strlen($docRoot));
    echo $relative;
} else {
    echo 'Путь вне корня документа';
}
?>

/assets/image.jpg

Обратите внимание: после удаления корня может остаться начальный слеш, что нормально для URL.

Сравнение путей с учётом чувствительности регистра

На Linux файловая система чувствительна к регистру, на Windows - нет. Для надёжного сравнения путей рекомендуется привести их к единому регистру с помощью strtolower() после realpath().

<?php
$path1 = realpath('/var/www/html/File.php');
$path2 = realpath('/var/www/html/file.php');
if (strtolower($path1) === strtolower($path2)) {
    echo 'Пути указывают на один файл (с точностью до регистра)';
}
?>

Вывод: строки могут совпадать или не совпадать в зависимости от реального существования файлов. Такой подход полезен для кэширования.

Получение списка всех включённых файлов с их путями

Для отладки или аудита может потребоваться массив всех файлов, подключенных через include/require. Для этого используется get_included_files().

<?php
// подключим несколько файлов
include 'config.php';
include 'functions.php';
$included = get_included_files();
print_r($included);
?>

Array
(
    [0] => /var/www/html/index.php
    [1] => /var/www/html/config.php
    [2] => /var/www/html/functions.php
)

Функция возвращает абсолютные пути, уже нормализованные. Это работает и с require_once, и с include_once.

Кросс-платформенная обработка путей: DIRECTORY_SEPARATOR

Windows использует обратную косую черту (\), Linux - прямую (/). Для совместимости используйте константу DIRECTORY_SEPARATOR или просто /, так как PHP под Windows тоже понимает прямую черту.

<?php
$path = __DIR__ . DIRECTORY_SEPARATOR . 'data' . DIRECTORY_SEPARATOR . 'file.txt';
echo $path;
// То же самое с /:
echo __DIR__ . '/data/file.txt';
?>

/var/www/html/data/file.txt

При работе с пользовательскими путями рекомендуется заменять обратные косые черты на прямые с помощью str_replace('\\', '/', $path).

Создание универсальной функции для получения пути скрипта

Иногда необходимо получить путь к папке, где лежит главный скрипт, даже если текущий файл является инклудом. Функция может использовать $_SERVER['SCRIPT_FILENAME'].

<?php
function getScriptDir() {
    $script = $_SERVER['SCRIPT_FILENAME'];
    if (!$script) {
        // fallback для CLI
        $script = $_SERVER['PHP_SELF'] ?? __FILE__;
    }
    return dirname(realpath($script));
}
echo getScriptDir();
?>

/var/www/html

Эта функция надёжна для веб-среды, но в CLI может дать неверный результат, поэтому требуется проверка.