Вывод ошибок PHP: конфигурация и обработка

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

Ниже приведены практические сценарии с кодом и результатами их выполнения.

Пример 1. Комбинированная настройка для разработки

Включение всех ошибок, установка пользовательского обработчика и отлов фатальных ошибок.

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

// Пользовательский обработчик нефатальных ошибок
set_error_handler(function($severity, $message, $file, $line) {
    $output = "<b>Ошибка уровня $severity:</b> $message в $file:$line";
    echo "<div style='color:red;'>$output</div>";
});

// Обработка фатальных ошибок
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && ($error['type'] === E_ERROR || $error['type'] === E_PARSE)) {
        echo "<div style='color:darkred; font-weight:bold;'>Фатальная ошибка: {$error['message']} в {$error['file']}:{$error['line']}</div>";
    }
});

// Демонстрация
echo $undefinedVar; // Notice
trigger_error('Пользовательское предупреждение', E_USER_WARNING);

Результат выполнения (вывод в браузере):

Ошибка уровня 8: Undefined variable: undefinedVar в /var/www/example.php:17
Ошибка уровня 512: Пользовательское предупреждение в /var/www/example.php:18

При вызове несуществующей функции (например, badFunc()) на экране появится сообщение о фатальной ошибке.

Пример 2. Логирование с разными стилями вывода

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

ini_set('display_errors', 0);
ini_set('log_errors', 1);
ini_set('error_log', __DIR__.'/errors.log');
error_reporting(E_ALL);

set_error_handler(function($severity, $message, $file, $line) {
    $logEntry = date('Y-m-d H:i:s')." [$severity] $message in $file:$line".PHP_EOL;
    file_put_contents(ini_get('error_log'), $logEntry, FILE_APPEND);
    echo "<p>Извините, произошла ошибка. Администратор уведомлен.</p>";
});

file_get_contents('/несуществующий_файл');

Содержимое errors.log после запуска:

2025-03-25 14:30:12 [2] file_get_contents(/несуществующий_файл): Failed to open stream: No such file or directory in /var/www/example.php:13

Пользователь видит только вежливое сообщение, а техническая информация сохраняется в логе.

Пример 3. Отлов исключений через set_exception_handler

Глобальный обработчик неперехваченных исключений.

set_exception_handler(function(\Throwable $exception) {
    echo "<b>Необработанное исключение:</b> " . $exception->getMessage();
    echo "<br>Файл: {$exception->getFile()}, строка {$exception->getLine()}";
});

throw new \InvalidArgumentException('Неверный аргумент');

Результат:

Необработанное исключение: Неверный аргумент
Файл: /var/www/example.php, строка 6

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

Пример 4. Использование error_reporting с битовыми масками

Демонстрация разных уровней.

error_reporting(E_ALL & ~E_NOTICE);
echo $notSet; // Notice подавлен, ничего не выведется

trigger_error('Это предупреждение', E_USER_WARNING); // будет выведено

// Включить обратно уведомления
error_reporting(E_ALL);
echo $notSet; // Notice теперь отображается

Вывод:

Notice: Undefined variable: notSet in /var/www/example.php на строке 9

Первое обращение к $notSet не вызвало сообщения, второе - вызвало, так как маска была изменена.

Пример 5. Проверка error_get_last после выполнения скрипта

Получение последней ошибки для кастомной обработки.

$result = @file_get_contents('http://example.com/notfound');
if ($result === false) {
    $lastError = error_get_last();
    if ($lastError) {
        echo "Не удалось загрузить: {$lastError['message']}";
    }
}

Результат:

Не удалось загрузить: file_get_contents(http://example.com/notfound): Failed to open stream: HTTP request failed! HTTP/1.1 404 Not Found

Здесь оператор @ подавляет вывод ошибки, но error_get_last позволяет её извлечь.