FastCGI и PHP: сообщение stderr об ошибках

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

Пример 1. Детальная настройка буферизации nginx с тестовым скриптом

Создадим PHP-скрипт, который генерирует большое сообщение в stderr:

<?php
// test_error.php
$error_message = str_repeat('Test error line ' . PHP_EOL, 1000); // 1000 строк
file_put_contents('php://stderr', $error_message);
echo "Script completed, check nginx logs\n";
?>

При обращении к скрипту без настройки буферов в логах nginx появится:

2025/03/15 10:00:00 [error] 1234#1234: *1 FastCGI sent in stderr: "PHP message: Test error line ..." while reading response header from upstream, client: 127.0.0.1, server: example.com, request: "GET /test_error.php HTTP/1.1", upstream: "fastcgi://unix:/run/php/php8.2-fpm.sock:", host: "example.com"

После добавления в location fastcgi_buffer_size 32k; и fastcgi_buffers 4 32k; сообщение исчезнет (если размер stderr меньше 128k). Вывод скрипта остаётся в теле ответа.

Пример 2. Настройка PHP-FPM пула с логированием в syslog

Вместо файла можно использовать syslog, что упрощает централизованный сбор логов:

; /etc/php/8.2/fpm/pool.d/www.conf
; вместо error_log = /path/to/file
php_admin_value[error_log] = syslog
php_admin_value[log_errors] = 1
; можно задать идентификатор
php_admin_value[syslog.ident] = PHP-FPM

Перезагрузка PHP-FPM. Теперь ошибки будут направляться в системный syslog (обычно /var/log/syslog или /var/log/messages). Сообщение 'fastcgi sent in stderr' исчезнет, так как PHP не пишет в stderr.

Mar 15 10:05:00 server PHP-FPM[3456]: [warning] ...

Пример 3. Использование пользовательского обработчика с регистрацией shutdown

Для перехвата всех типов ошибок (включая фатальные) используем комбинацию set_error_handler и register_shutdown_function:

<?php
// Полный перехват ошибок
set_error_handler(function($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) return;
    error_log("Custom handler: severity=$severity, $message in $file:$line");
});

register_shutdown_function(function() {
    $error = error_get_last();
    if ($error !== null && $error['type'] === E_ERROR) {
        error_log("Fatal error: " . $error['message'] . " in " . $error['file'] . ":" . $error['line']);
    }
});

// Вызов ошибки
call_user_func('undefined_function');
?>

Результат: в error_log появится запись о фатальной ошибке, а stderr останется пустым (если log_errors выключен или перенаправлен).

Пример 4. Перенаправление stderr в nginx с помощью fastcgi_intercept_errors

Если нужно, чтобы ошибки из stderr отображались как ответ 500, а не просто в логе, можно включить fastcgi_intercept_errors on. Тогда сообщение 'fastcgi sent in stderr' не появится, а вместо него будет возвращён код 500 (само сообщение не выводится клиенту).

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    fastcgi_intercept_errors on;
    error_page 500 /500.html;
}

Проверка: ошибка PHP теперь не пишется ни в лог, ни в stderr - nginx возвращает 500. Для отладки следует оставить лог ошибок (доступен через upstream's response).

Пример 5. Сравнение конфигураций Apache (mod_fastcgi vs mod_proxy_fcgi)

Если используется Apache с mod_fastcgi (устаревший), для увеличения буфера необходимо задать FastCgiBufferSize в конфигурации виртуального хоста:

FastCgiBufferSize 65536

Для mod_proxy_fcgi (современный) директива ProxyFCGIBufferSize доступна в контексте <Proxy>:

<Proxy "fcgi://localhost:9000/">
    ProxyFCGIBufferSize 65536
    ProxySet timeout=300
</Proxy>

После изменения перезапустите Apache и проверьте лог на наличие 'FastCGI sent in stderr'.