Организация путей и файловых операций через директорию index.php

Расширенный пример: рекурсивный обход директорий

Использование RecursiveDirectoryIterator для обхода всех поддиректорий относительно index.php.

$dir = new RecursiveDirectoryIterator(__DIR__, RecursiveDirectoryIterator::SKIP_DOTS);
$iterator = new RecursiveIteratorIterator($dir, RecursiveIteratorIterator::SELF_FIRST);
foreach ($iterator as $fileinfo) {
    if ($fileinfo->isDir()) {
        echo "D: " . $fileinfo->getPathname() . "\n";
    } else {
        echo "F: " . $fileinfo->getPathname() . "\n";
    }
}

// Пример вывода для структуры:
// /var/www/html/
//   index.php
//   includes/
//     config.php
//   lib/
//     helpers.php
D: /var/www/html/includes
F: /var/www/html/includes/config.php
D: /var/www/html/lib
F: /var/www/html/lib/helpers.php

Пример: использование __FILE__ для обработки символических ссылок

Если index.php является символической ссылкой, то __FILE__ возвращает путь к ссылке, а не к реальному файлу. Для получения реальной директории используйте realpath(dirname(__FILE__)).

// index.php является ссылкой на /other/path/real_index.php
$realDir = realpath(dirname(__FILE__));
echo $realDir; // выведет /other/path

Пример: создание простого маршрутизатора на основе директорий

Сканирование поддиректорий для определения маршрутов.

$requestUri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$segments = explode('/', trim($requestUri, '/'));
$controllerDir = __DIR__ . '/controllers';
if (!empty($segments[0]) && is_dir($controllerDir . '/' . $segments[0])) {
    $controllerFile = $controllerDir . '/' . $segments[0] . '/index.php';
    if (file_exists($controllerFile)) {
        require $controllerFile;
    }
}

Пояснение: такой подход позволяет организовать модульную структуру, где каждая директория в controllers содержит свой index.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;
    }
});

Это стандартная реализация PSR-4, где корневая директория src соответствует пространству имён App.

Пример: кэширование результатов сканирования директории

Для ускорения повторных обращений можно сохранять список файлов в переменную или файл.

$cacheFile = __DIR__ . '/cache/filelist.php';
if (file_exists($cacheFile)) {
    $files = include $cacheFile;
} else {
    $files = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator(__DIR__, RecursiveDirectoryIterator::SKIP_DOTS)
    );
    $fileList = [];
    foreach ($files as $file) {
        if ($file->isFile()) {
            $fileList[] = $file->getPathname();
        }
    }
    file_put_contents($cacheFile, '<? return ' . var_export($fileList, true) . ';');
    $files = $fileList;
}
print_r($files);

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

Пояснение: при первом вызове создаётся кеш, при последующих – данные загружаются из кеша. Это снижает нагрузку на файловую систему.