Обработка исключений при включении файлов в PHP

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

В этом разделе приведены более сложные сценарии, демонстрирующие продвинутые техники перехвата и обработки ошибок при включении файлов.

Пример 1. Множественные включения с обработкой ошибок через пользовательский обработчик

Если требуется подключить несколько файлов и ловить каждую ошибку отдельно, удобно создать функцию-обёртку.

<?php
class IncludeException extends Exception {}

function includeWithException($file) {
    set_error_handler(function ($severity, $message, $fileErr, $line) use ($file) {
        throw new IncludeException("Ошибка включения $file: $message");
    }, E_WARNING);
    try {
        include $file;
    } finally {
        restore_error_handler();
    }
}

$files = ['header.php', 'content.php', 'footer.php'];
foreach ($files as $f) {
    try {
        includeWithException($f);
    } catch (IncludeException $e) {
        echo $e->getMessage() . "\n";
    }
}
?>

Ошибка включения header.php: include(header.php): Failed to open stream: No such file or directory
Ошибка включения content.php: include(content.php): Failed to open stream: No such file or directory
footer.php подключён успешно (если файл существует)

Пример 2. Включение с буферизацией вывода для изоляции ошибок

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

<?php
$file = 'unstable_script.php';
ob_start();
$errorCaught = false;
set_error_handler(function ($severity, $message) use (&$errorCaught) {
    $errorCaught = true;
    throw new ErrorException($message);
});

try {
    include $file;
} catch (ErrorException $e) {
    // очищаем частично выведенный контент
    ob_clean();
    echo 'Ошибка в скрипте: ' . $e->getMessage();
} finally {
    restore_error_handler();
    ob_end_flush();
}
?>

Если unstable_script.php выдаёт предупреждение и выводит текст, этот текст будет удалён, и будет показано только сообщение об ошибке.

Пример 3. Использование include внутри try с глобальным обработчиком и восстановлением

Иногда требуется, чтобы все вызовы include в определённом блоке кода генерировали исключения. Устанавливается обработчик один раз для всей области видимости.

<?php
function strictErrorHandler($severity, $message, $file, $line) {
    throw new ErrorException($message, 0, $severity, $file, $line);
}

set_error_handler('strictErrorHandler');

try {
    include 'config.php';
    include 'database.php';
    include 'functions.php';
} catch (ErrorException $e) {
    echo sprintf('Ошибка при загрузке: [%s] %s', $e->getSeverity(), $e->getMessage());
} finally {
    restore_error_handler();
}
?>

Пример 4. Обработка синтаксических ошибок в подключаемом файле

Если в файле присутствует синтаксическая ошибка, include генерирует фатальную ошибку, которая не перехватывается обычным способом. Однако можно использовать register_shutdown_function в сочетании с error_get_last.

<?php
register_shutdown_function(function () {
    $error = error_get_last();
    if ($error && $error['type'] === E_PARSE) {
        echo 'Синтаксическая ошибка в файле: ' . $error['message'];
    }
});

include 'syntax_error.php';
?>

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

Пример 5. Комбинирование include с проверкой через is_file и stream_resolve_include_path

Для более надёжной проверки перед включением можно симулировать логику поиска файла, используя stream_resolve_include_path().

<?php
function includeIfExists($file) {
    $resolved = stream_resolve_include_path($file);
    if ($resolved !== false) {
        include $resolved;
        return true;
    }
    return false;
}

if (!includeIfExists('vendor/autoload.php')) {
    throw new RuntimeException('Composer autoload не найден');
}
?>

Этот подход полезен, когда include_path содержит несколько директорий и нужно точно знать, какой файл будет загружен.