Работа с include и require в PHP на стороне сервера

Расширенные примеры работы с include

Рекурсивное включение файлов с проверкой глубины

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

<?php
function includeRecursive($dir, $depth = 0, $maxDepth = 3) {
    if ($depth > $maxDepth) return;
    $files = glob($dir . '/*.php');
    foreach ($files as $file) {
        include $file;
    }
    $subdirs = glob($dir . '/*', GLOB_ONLYDIR);
    foreach ($subdirs as $subdir) {
        includeRecursive($subdir, $depth + 1, $maxDepth);
    }
}

includeRecursive(__DIR__ . '/components');
?>

Результат: все PHP-файлы из папки components и её подпапок (глубиной до 3) будут выполнены. Если файл содержит определение функции, повторное включение вызовет ошибку. Для предотвращения этого используйте include_once.

Автозагрузка классов через spl_autoload_register с include

Современные приложения используют автозагрузку для подключения классов по мере необходимости. В этом примере реализована простая автозагрузка, соответствующая стандарту PSR-4.

<?php
spl_autoload_register(function ($className) {
    // Преобразование namespace в путь: App\Models\User -> src/Models/User.php
    $prefix = 'App\\';
    $baseDir = __DIR__ . '/src/';
    
    if (strncmp($prefix, $className, strlen($prefix)) !== 0) {
        return; // класс не относится к нашему пространству
    }
    
    $relativeClass = substr($className, strlen($prefix));
    $file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
    
    if (file_exists($file)) {
        require_once $file;
    }
});

// Теперь можно использовать классы без явного include
$user = new \App\Models\User();
?>

Результат: при создании объекта User() PHP автоматически находит и подключает файл src/Models/User.php с помощью require_once.

Включение файла с проверкой существования и повторной попыткой

В распределённых системах файлы могут временно отсутствовать. Пример демонстрирует механизм повторных попыток с задержкой.

<?php
$file = __DIR__ . '/data/config.json';
$maxAttempts = 3;
$attempt = 0;
$included = false;

while ($attempt < $maxAttempts && !$included) {
    if (file_exists($file)) {
        $config = include $file; // файл возвращает массив
        $included = true;
        echo 'Конфигурация загружена с попытки ' . ($attempt + 1);
    } else {
        $attempt++;
        if ($attempt < $maxAttempts) {
            sleep(1); // пауза 1 секунда
        }
    }
}

if (!$included) {
    echo 'Не удалось загрузить конфигурацию после ' . $maxAttempts . ' попыток';
}
?>

Результат: если файл существует, он включается и возвращает данные (предполагается, что конфиг содержит return [...]). Если файла нет, программа ждёт и повторяет попытку до трёх раз.

Использование include с потоковым обёрткой php://input

Хотя php://input предназначен для чтения сырых данных запроса, его можно использовать вместе с include для выполнения кода, переданного в теле POST-запроса (опасно, только для отладки).

<?php
// Внимание: крайне небезопасно! Только для локальных тестов.
if ($_SERVER['REMOTE_ADDR'] === '127.0.0.1') {
    include 'php://input';
} else {
    echo 'Доступ запрещён';
}
?>

Результат: при отправке POST-запроса с телом, содержащим PHP-код, этот код выполнится, но только с локального адреса. Пример показывает, как можно комбинировать include с stream wrapper.