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

Ниже приведены различные примеры настройки отображения ошибок с подробными пояснениями.

Пример 1: Разные уровни error_reporting

<?php
// Показать все ошибки, кроме уведомлений (NOTICE)
error_reporting(E_ALL & ~E_NOTICE);
ini_set('display_errors', 1);

// Пример кода с ошибками
echo $undefined_var; // Warning
echo 1/0; // Warning
trigger_error('Пользовательская ошибка', E_USER_NOTICE); // Не будет показана
?>

Warning: Undefined variable $undefined_var in /path/to/script.php on line 7
Warning: Division by zero in /path/to/script.php on line 8

Пояснение: уровень E_ALL & ~E_NOTICE исключает уведомления, поэтому E_USER_NOTICE не выводится.

Пример 2: Использование @ для подавления и error_get_last()

<?php
@$result = 1/0; // Подавление ошибки
$lastError = error_get_last();
if ($lastError !== null) {
    echo 'Последняя ошибка: ', $lastError['message'];
}
?>

Последняя ошибка: Division by zero

Пояснение: оператор @ временно отключает отображение конкретной ошибки, но она всё равно может быть получена через error_get_last(). Однако подавление не рекомендуется, так как затрудняет отладку.

Пример 3: Комбинация display_errors и log_errors для разработки

<?php
// Включить отображение на экран и запись в лог одновременно
ini_set('display_errors', 1);
ini_set('log_errors', 1);
ini_set('error_log', '/path/to/php_errors.log');
error_reporting(E_ALL);

trigger_error('Тестовая ошибка', E_USER_WARNING);
echo 'Скрипт продолжает работу';
?>

Warning: Тестовая ошибка in /path/to/script.php on line 8
Скрипт продолжает работу

В файле php_errors.log появится запись с той же ошибкой. Такой подход позволяет и видеть ошибки в браузере, и сохранять их для последующего анализа.

Пример 4: Пользовательский обработчик с перехватом фатальных ошибок

<?php
function customErrorHandler($severity, $message, $file, $line) {
    echo "<b>Ошибка уровня $severity:</b> $message в $file:$line<br>";
    return true;
}
set_error_handler('customErrorHandler');

function shutdownHandler() {
    $error = error_get_last();
    if ($error !== null && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_CORE_WARNING])) {
        echo "<b>Фатальная ошибка:</b> {$error['message']} в {$error['file']}:{$error['line']}<br>";
    }
}
register_shutdown_function('shutdownHandler');

// Фатальная ошибка: вызов несуществующей функции
existingFunction();
?>

Фатальная ошибка: Call to undefined function existingFunction() in /path/to/script.php on line 18

Пояснение: register_shutdown_function позволяет перехватывать ошибки, которые не обрабатываются set_error_handler, и выводить их аналогично.

Пример 5: Настройка отображения ошибок в production (отключение вывода, включение логирования)

<?php
// В production среде ошибки не должны показываться пользователю
ini_set('display_errors', 0);
ini_set('log_errors', 1);
ini_set('error_log', '/var/log/php_errors.log');
error_reporting(E_ALL & ~E_DEPRECATED & ~E_STRICT);
?>

Пояснение: display_errors выключен, чтобы избежать утечки информации. Все ошибки записываются в лог. Уровень снижен, чтобы игнорировать устаревшие конструкции, которые не критичны.

Пример 6: Конфигурация через .htaccess с разными значениями

# Включить отображение всех ошибок
php_flag display_errors on
php_value error_reporting E_ALL
php_flag display_startup_errors on

# Альтернативный вариант: показывать только фатальные и предупреждения
# php_value error_reporting E_ERROR | E_WARNING

Пояснение: в .htaccess можно комбинировать флаги. Значение E_ALL можно заменить на числовой эквивалент (32767) для совместимости. Директива display_startup_errors полезна для отладки ошибок загрузки расширений.