php:8.0-apache Docker容器内Web服务始终返回200状态码问题求助

问题原因 #

1. 代码执行顺序不符合HTTP响应的生成逻辑：你在代码中先执行echo输出响应体，再调用http_response_code()设置状态码。HTTP协议要求响应头必须早于响应体发送，一旦响应体已经开始发送，后续再修改状态码等响应头就会失效，同时PHP会抛出headers already sent的警告（你可以查看容器的标准错误日志确认该警告存在）。
2. 容器内外PHP配置不一致：你本地环境默认开启了output_buffering（输出缓冲），输出的内容会先暂存在缓冲区中，直到脚本执行完毕才会统一发送响应头和响应体，所以即使顺序写反也能正常设置状态码。而你在容器中仅配置了日志相关参数，没有显式开启output_buffering，容器内PHP的output_buffering采用默认关闭配置，输出内容时会直接发送默认200状态码的响应头，后续的状态码修改自然无效。

解决办法 #

方案1（推荐，不依赖配置） #

调整代码顺序，将状态码设置放到所有输出操作之前：

<?php
http_response_code(400);
echo '{some json content}';
exit;

该写法完全符合HTTP响应的生成逻辑，无需依赖任何PHP配置就能在所有环境正常运行。

方案2（兼容现有代码） #

在你的php.ini配置文件中添加一行，显式开启输出缓冲：

output_buffering = 4096

修改后重新构建Docker镜像即可生效。

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