如何强制Nginx覆盖PHP CGI返回的HTTP状态码？

方法一：使用map指令（推荐，符合Nginx配置最佳实践） #

1. 在Nginx的http全局配置块中添加状态码映射规则：

map $upstream_status $final_status {
    # 将上游返回的405状态码替换为200
    405 200;
    # 其他状态码保持不变
    default $upstream_status;
}

2. 在处理PHP请求的location块中，启用上游状态码存储，并指定最终返回的状态码：

location ~ \.php$ {
    # 替换为你的PHP-FPM地址（unix套接字或IP:端口）
    fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
    
    # 基础FastCGI参数配置（根据你的环境调整）
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
    
    # 启用该指令，让Nginx将PHP-FPM返回的状态码保存到$upstream_status变量
    fastcgi_store_status on;
    
    # 返回预先映射好的状态码，同时保留PHP输出的响应内容
    return $final_status;
}

方法二：使用if指令（简单直接，注意Nginx的if使用限制） #

如果需要更精简的配置，可以在PHP请求的location块中直接判断上游状态码并替换：

location ~ \.php$ {
    fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
    
    # 启用上游状态码存储
    fastcgi_store_status on;
    
    # 当上游返回405时，强制返回200状态码
    if ($upstream_status = 405) {
        return 200;
    }
}

注意事项 #

• fastcgi_store_status on是核心配置，它让Nginx能够捕获PHP-FPM返回的原始状态码到$upstream_status变量中，这是后续判断和替换的基础。
• 两种方法都会保留PHP脚本输出的内容（比如示例中的hi），仅修改响应的状态码。
• 确保你的Nginx版本支持fastcgi_store_status指令（该指令从Nginx 1.13.10版本开始引入）。

内容的提问来源于stack exchange，提问作者Mohamad Reza