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

Расширенные примеры использования путей к папке скрипта

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

Часто в проектах требуется знать абсолютный путь к корневой директории независимо от того, где находится вызывающий скрипт. Определение корня через относительные пути может быть ненадёжным. Ниже представлен способ на основе __DIR__ и конфигурационного файла.

<?php
// Файл config.php в корне проекта
define('ROOT_PATH', __DIR__);
?>

// В любом другом файле
require_once __DIR__ . '/config.php';
echo ROOT_PATH;
?>

/var/www/html/project

Пояснение: константа ROOT_PATH определяется в файле, расположенном в корне. Все остальные скрипты подключают этот файл и используют константу. Такой подход исключает дублирование кода и упрощает поддержку.

Пример 2: Автозагрузка классов PSR-4 с динамическим определением путей

В современных PHP проектах автозагрузка классов обычно настраивается через Composer. Но вручную можно реализовать автозагрузку, используя путь к папке скрипта.

<?php
spl_autoload_register(function ($class) {
    $prefix = 'App\\';
    $baseDir = __DIR__ . '/src/';
    $len = strlen($prefix);
    if (strncmp($prefix, $class, $len) !== 0) {
        return;
    }
    $relativeClass = substr($class, $len);
    $file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
    if (file_exists($file)) {
        require $file;
    }
});
?>

Результат: при обращении к классу App\Controller\User будет загружен файл src/Controller/User.php.

Пояснение: __DIR__ указывает на папку, где находится файл с регистрацией автозагрузчика, а $baseDir задаёт корень пространства имён. Это гарантирует правильную загрузку независимо от того, из какого скрипта вызван класс.

Пример 3: Определение пути к логам относительно скрипта

Логи часто сохраняются в папку, расположенную на уровень выше корня приложения. Используя dirname(__DIR__), можно сформировать путь безопасно.

<?php
$logDir = dirname(__DIR__) . '/logs';
if (!is_dir($logDir)) {
    mkdir($logDir, 0775, true);
}
$logFile = $logDir . '/app.log';
error_log('Тестовое сообщение', 3, $logFile);
?>

Результат: в файл logs/app.log будет записано сообщение.

Пояснение: использование абсолютного пути исключает зависимость от текущей рабочей директории и делает код переносимым.

Пример 4: Разрешение относительных путей с помощью realpath() для безопасного include

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

<?php
$relativePath = '../config/database.php';
$absolutePath = realpath(__DIR__ . '/' . $relativePath);
if ($absolutePath !== false) {
    require $absolutePath;
} else {
    echo 'Файл не найден';
}
?>

Пояснение: realpath() разрешает все .. и симлинки, возвращая канонический путь. Если файл существует, он подключается; иначе – обработка ошибки.

Пример 5: Определение пути к папке скрипта при работе в CLI

В командной строке переменная $_SERVER может быть неполной. __DIR__ всегда доступен.

<?php
// script.php в /home/user/project/bin/
$scriptDir = __DIR__;
echo "Скрипт запущен из: $scriptDir";
?>

Скрипт запущен из: /home/user/project/bin

Пояснение: в CLI __DIR__ работает так же, как в веб-среде. Это делает его универсальным решением для всех режимов работы PHP.