Обработка предупреждений PHP: настройка отображения и логирования

Расширенные примеры управления предупреждениями

Пример 1: Комбинирование display_errors и log_errors

Сценарий: на локальной машине нужно видеть все ошибки, но на тестовом сервере только логировать их.

if (php_sapi_name() === 'cli') {
    ini_set('display_errors', '1');
    error_reporting(E_ALL);
} else {
    ini_set('display_errors', '0');
    ini_set('log_errors', '1');
    ini_set('error_log', '/tmp/php_errors.log');
    error_reporting(E_ALL & ~E_DEPRECATED);
}

// Провокация ошибки
trigger_error('Тестовое предупреждение', E_USER_WARNING);

Результат в браузере: ничего не выведено (если не CLI). В журнале /tmp/php_errors.log появится запись с временем и сообщением.

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

Стандартный set_error_handler не ловит E_ERROR. Используем register_shutdown_function для получения последней ошибки.

function shutdownHandler() {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
        error_log("Фатальная ошибка: {$error['message']} в {$error['file']}:{$error['line']}");
        http_response_code(500);
        echo "Критическая ошибка, администратор уведомлён.";
    }
}

function warningHandler($severity, $message, $file, $line) {
    error_log("Предупреждение: $message в $file:$line");
}

set_error_handler('warningHandler');
register_shutdown_function('shutdownHandler');

// Фатальная ошибка:
echo $undefined->method();

Вывод: "Критическая ошибка, администратор уведомлён." В лог попадёт сообщение о фатальной ошибке.

Пример 3: Класс для централизованного логирования с Monolog

Использование популярной библиотеки для гибкого логирования. Устанавливается через Composer: composer require monolog/monolog.

use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\ErrorHandler;

$log = new Logger('app');
$log->pushHandler(new StreamHandler('/var/log/app.log', Logger::WARNING));

// Автоматически перехватывает PHP ошибки и исключения
ErrorHandler::register($log);

// Теперь все предупреждения уходят в лог
trigger_error('Ошибка в модуле оплаты', E_USER_WARNING);

// Можно ещё добавить ручное логирование
$log->warning('Устаревший метод вызван', ['class' => 'OldClass']);

В файле /var/log/app.log появится запись формата Monolog: [2023-10-15 10:00:00] app.WARNING: Ошибка в модуле оплаты [] []

Пример 4: Сравнение производительности при использовании @ и error_reporting

Оператор @ замедляет выполнение, так как PHP включает механизм подавления. Error_reporting работает быстрее.

$start = microtime(true);
for ($i = 0; $i < 10000; $i++) {
    @file_get_contents('/tmp/nonexistent_' . $i);
}
echo "Время с @: " . (microtime(true) - $start) . " сек\n";

error_reporting(E_ALL & ~E_WARNING);
$start = microtime(true);
for ($i = 0; $i < 10000; $i++) {
    file_get_contents('/tmp/nonexistent_' . $i);
}
error_reporting(E_ALL);
echo "Время с error_reporting: " . (microtime(true) - $start) . " сек\n";

Примерный вывод:
Время с @: 0.245 сек
Время с error_reporting: 0.089 сек

Вывод: использование error_reporting предпочтительнее по производительности.

Пример 5: Генерация пользовательских предупреждений с категориями

Используйте trigger_error() с разными уровнями для разделения логики.

define('E_USER_INFO', 1024); // Пользовательский уровень
trigger_error('Информационное сообщение', E_USER_INFO); // По умолчанию вызовет обработчик только для E_USER_WARNING и выше

// Но можно в обработчике проверять код:
set_error_handler(function($severity, $msg, $file, $line) {
    if ($severity === 1024) {
        error_log("[INFO] $msg");
    } elseif ($severity === E_USER_WARNING) {
        error_log("[WARNING] $msg");
    }
});

trigger_error('Пользовательское предупреждение', E_USER_WARNING);

В лог попадут обе записи, но для E_USER_INFO - с тегом INFO, для E_USER_WARNING - с тегом WARNING.