Файл ошибок PHP: как настроить логирование и анализировать сбои

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

Далее представлены более неочевидные сценарии и приёмы.

Запись в разные файлы по типу ошибки

Можно разделить предупреждения и фатальные ошибки с помощью пользовательского обработчика.

function smartErrorHandler($severity, $message, $file, $line) {
    $logDir = __DIR__ . '/logs';
    if (!is_dir($logDir)) mkdir($logDir, 0777, true);
    $logFile = ($severity & (E_ERROR | E_WARNING)) ? 'critical.log' : 'notice.log';
    $entry = date('Y-m-d H:i:s') . " [$severity] $message в $file:$line" . PHP_EOL;
    file_put_contents("$logDir/$logFile", $entry, FILE_APPEND | LOCK_EX);
}
set_error_handler('smartErrorHandler');

trigger_error('Тестовое уведомление', E_USER_NOTICE);
trigger_error('Тестовая ошибка', E_USER_WARNING);

Файл notice.log:
2025-03-22 12:00:00 [1024] Тестовое уведомление в /path/to/script.php:17
Файл critical.log:
2025-03-22 12:00:00 [512] Тестовая ошибка в /path/to/script.php:18

Класс тяжести 1024 - E_USER_NOTICE, 512 - E_USER_WARNING.

Автоматическая ротация логов с помощью cron

Логи могут занимать много места. Ротация по расписанию через системный cron или сам PHP.

// Скрипт rotate.php
$logFile = '/var/log/php_errors.log';
$maxSize = 10 * 1024 * 1024; // 10 MB
if (file_exists($logFile) && filesize($logFile) > $maxSize) {
    $backup = $logFile . '.' . date('Y-m-d_H:i:s');
    rename($logFile, $backup);
    touch($logFile);
    chmod($logFile, 0644);
    echo "Ротация выполнена: $backup\n";
}

Выполнять по cron ежедневно: 0 3 * * * php /path/to/rotate.php

Логирование в формате JSON для анализатора

Современные системы (ELK, Graylog) лучше работают со структурированными данными.

function jsonErrorHandler($severity, $message, $file, $line) {
    $entry = json_encode([
        'timestamp' => date('c'),
        'severity'  => $severity,
        'message'   => $message,
        'file'      => $file,
        'line'      => $line
    ]) . PHP_EOL;
    file_put_contents('errors.json', $entry, FILE_APPEND);
}
set_error_handler('jsonErrorHandler');
trigger_error('Пример JSON лога', E_USER_WARNING);

Содержимое errors.json:
{"timestamp":"2025-03-22T12:00:00+00:00","severity":512,"message":"Пример JSON лога","file":"...","line":10}

Отправка критических ошибок на email

Совмещение записи в файл и уведомления по почте.

function emailOnFatal($message, $file, $line) {
    $to = 'admin@example.com';
    $subject = 'Критическая ошибка на сайте';
    $body = "Ошибка: $message\nФайл: $file\nСтрока: $line\n";
    file_put_contents('errors.log', $body, FILE_APPEND);
    mail($to, $subject, $body);
}
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && $error['type'] === E_ERROR) {
        emailOnFatal($error['message'], $error['file'], $error['line']);
    }
});

Важно: не злоупотреблять, чтобы не завалить почтовый ящик.

Интеграция с Monolog (комплексный подход)

Библиотека Monolog предоставляет гибкие каналы и форматирование.

// Установка: composer require monolog/monolog
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Handler\NativeMailerHandler;

$log = new Logger('app');
$log->pushHandler(new StreamHandler(__DIR__ . '/app.log', Logger::WARNING));
$log->pushHandler(new NativeMailerHandler('admin@example.com', 'Ошибка', 'отладчик@example.com', Logger::CRITICAL));

$log->warning('Предупреждение: значение вне диапазона');
$log->error('Критическая ошибка базы данных');

В app.log:
[2025-03-22T12:00:00+00:00] app.WARNING: Предупреждение: значение вне диапазона [] []
[2025-03-22T12:00:01+00:00] app.ERROR: Критическая ошибка базы данных [] []

Использование error_get_last для анализа последней ошибки

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

@file_get_contents('/несуществующий_файл');
$lastError = error_get_last();
if ($lastError) {
    print_r($lastError);
}

Array
(
    [type] => 2
    [message] => file_get_contents(/несуществующий_файл): Failed to open stream: No such file or directory
    [file] => /path/to/script.php
    [line] => 2
)

Полезно для диагностики после выполнения сложного запроса.