Настройка каталогов и путей в PHP: от include_path до автозагрузки

Расширенные примеры настройки путей

// Пример 1: Рекурсивное сканирование и добавление всех подкаталогов в include_path
function addSubdirectoriesToIncludePath($baseDir) {
    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($baseDir, RecursiveDirectoryIterator::SKIP_DOTS)
    );
    $paths = [get_include_path()];
    foreach ($iterator as $fileInfo) {
        if ($fileInfo->isDir()) {
            $paths[] = $fileInfo->getPathname();
        }
    }
    set_include_path(implode(PATH_SEPARATOR, array_unique($paths)));
}
addSubdirectoriesToIncludePath('/var/www/libs');
echo 'Новый include_path: ' . get_include_path();

Новый include_path: /var/www/libs/sub1:/var/www/libs/sub2:/usr/share/php:.

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

// Пример 2: Проверка, найдётся ли файл в текущем include_path
function fileExistsInIncludePath($filename) {
    $resolved = stream_resolve_include_path($filename);
    if ($resolved !== false) {
        return $resolved;
    }
    return false;
}
$file = 'utils.php';
if ($path = fileExistsInIncludePath($file)) {
    echo "Файл $file найден в: $path";
} else {
    echo "Файл $file не найден в include_path";
}

Файл utils.php найден в: /var/www/lib/utils.php

Цель: отладка - проверить, какой именно файл будет загружен при использовании require_once.

// Пример 3: Изменение include_path только для одного подключения (без глобального изменения)
$oldPath = set_include_path('/custom/lib' . PATH_SEPARATOR . get_include_path());
require_once 'special.php';
set_include_path($oldPath); // восстановление

(Код выполнится без вывода, но файл special.php будет загружен из /custom/lib)

Цель: временное изменение для загрузки одного файла, чтобы не влиять на остальной код.

// Пример 4: Настройка include_path для веб-сервера через .htaccess с проверкой
// .htaccess
php_value auto_prepend_file /var/www/prepend.php
php_value include_path ".:/var/www/includes"
// prepend.php
if (strpos(get_include_path(), '/var/www/includes') === false) {
    error_log('Include_path не установлен через .htaccess');
}

(В лог ошибок сервера будет записано сообщение, если .htaccess не сработал)

Цель: проверка корректности применения настроек виртуального хоста.

// Пример 5: Пользовательский автозагрузчик с поддержкой нескольких каталогов
spl_autoload_register(function ($class) {
    $dirs = [
        __DIR__ . '/src',
        __DIR__ . '/lib',
        __DIR__ . '/vendor'
    ];
    $relativePath = str_replace('\\', '/', $class) . '.php';
    foreach ($dirs as $dir) {
        $fullPath = $dir . '/' . $relativePath;
        if (file_exists($fullPath)) {
            require $fullPath;
            return;
        }
    }
});

(При вызове new \MyLib\Calculator() будет проверен каждый каталог)

Цель: альтернатива Composer для небольших проектов без менеджера зависимостей.

// Пример 6: Временное изменение PATH для вызова внешней утилиты
$originalPath = getenv('PATH');
putenv('PATH=' . $originalPath . ':/opt/ghostscript/bin');
$output = shell_exec('gs --version 2>&1');
echo 'GhostScript version: ' . $output;
putenv('PATH=' . $originalPath); // восстановление

GhostScript version: 9.55.0

Цель: безопасный вызов специфической версии утилиты без изменения глобального окружения.