PHP-FPM与Nginx：开启display_errors同时返回HTTP 500状态码的方法

方法一：自定义PHP错误处理器 #

通过PHP内置的错误处理机制，在错误发生时主动发送HTTP 500状态码，同时保留错误内容的显示效果。

在项目入口文件（如index.php）或全局加载的配置文件中添加以下代码：

// 注册运行时错误处理器
set_error_handler(function($errno, $errstr, $errfile, $errline) {
    // 仅处理当前error_reporting级别下的错误
    if (!(error_reporting() & $errno)) {
        return false;
    }

    // 发送500状态码
    http_response_code(500);

    // 返回false让PHP继续输出默认错误信息（依赖display_errors=on）
    return false;
});

// 处理语法解析错误（这类错误会直接终止脚本，无法被普通错误处理器捕获）
register_shutdown_function(function() {
    $lastError = error_get_last();
    if ($lastError && in_array($lastError['type'], [E_PARSE, E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR])) {
        // 发送500状态码
        http_response_code(500);
        // 手动输出错误内容，确保语法错误也能正常显示
        echo "<b>{$lastError['message']}</b> in <b>{$lastError['file']}</b> on line <b>{$lastError['line']}</b>";
    }
});

说明：

• 普通运行时错误由set_error_handler捕获，发送状态码后保留默认错误输出；
• 语法解析错误会直接中断脚本，通过register_shutdown_function在脚本终止前补发送状态码并输出错误。

方法二：Nginx层动态修改状态码（补充方案） #

如果不想修改PHP代码，可借助Nginx的Lua模块（需安装OpenResty或编译Lua支持），通过判断响应内容中的错误特征修改状态码。修改你的Nginx location配置：

location ~ \.php$ {
    try_files  $uri =404;
    include fastcgi_params;
    fastcgi_intercept_errors on;
    fastcgi_pass unix:/run/php/php-fpm.sock;
    fastcgi_param  SCRIPT_FILENAME  $request_filename;

    // 检查响应内容，若包含PHP致命/解析错误则设为500状态码
    body_filter_by_lua_block {
        local response_body = ngx.arg[1]
        if string.find(response_body, "Parse error:") or string.find(response_body, "Fatal error:") then
            ngx.status = 500
        end
    }
}

注意：这种方式属于事后判断，仅针对特定错误关键词生效，可靠性不如PHP层主动发送状态码。

验证步骤 #

创建测试文件test.php，故意留语法错误：

<?php
echo "test"

访问该文件时，浏览器应显示PHP错误信息，同时通过开发者工具可确认HTTP状态码为500。

内容的提问来源于stack exchange，提问作者Dr. Gianluigi Zane Zanettini