Apache配置PHP后页面空白解决方法

Apache配置PHP后页面空白问题往往并非PHP模块未加载，而是PHP脚本虽已执行却因错误被静默屏蔽、UTF-8 BOM干扰、输出缓冲未刷新或处理器配置不当等原因导致内容无法输出；解决关键在于先用phpinfo()确认PHP正常运行，再依次排查display_errors和error_reporting是否开启、文件是否含BOM头、output_buffering是否阻塞响应，以及AddType/SetHandler配置是否正确——每一步都直击“有请求无输出”的真实症结，帮你快速从白屏走向清晰报错与稳定响应。

Apache 配置 PHP 后页面空白，绝大多数情况不是 Apache 没加载 PHP 模块，而是 PHP 脚本执行了但没输出内容——或者输出被意外截断、缓冲干扰、错误静默吞掉。先确认 phpinfo() 能正常显示，再往下排查。

检查 PHP 是否真在运行（而非 Apache 直接返回空响应）

很多“空白页”其实是 Apache 返回了 200 状态但 body 为空，说明请求进了 PHP，但 PHP 没 echo/print 任何东西，或出错后没报错。

• 新建一个 /var/www/html/test.php，内容只有一行：
• 浏览器访问 http://localhost/test.php；如果也空白，但 curl -I http://localhost/test.php 返回 HTTP/1.1 200 OK，说明 PHP 进程在跑，问题出在脚本或配置
• 如果 curl -v http://localhost/test.php 显示 Content-Length: 0 或完全无 body，重点查 display_errors 和 error_reporting

PHP 错误被静默吞掉：关键 ini 设置

默认情况下，PHP 在生产环境会关闭错误显示，导致语法错误、致命错误发生时页面直接变空，连 HTTP 状态码都可能是 200。

• 确认 display_errors = On 且 error_reporting = E_ALL 在当前生效的 php.ini 中（用 phpinfo() 查 “Loaded Configuration File” 路径）
• 如果改的是全局 php.ini，记得重启 Apache：sudo systemctl restart apache2（Ubuntu/Debian）或 sudo apachectl restart（macOS）
• 临时在脚本开头加： —— 如果这时能看到 “test”，说明确实是错误被屏蔽了

输出缓冲（output_buffering）和 BOM 导致的空白

PHP 文件开头有 UTF-8 BOM、或 output_buffering 开启但未 flush，都可能导致浏览器收不到内容，表现为白屏。

• 用 hexdump -C test.php | head 检查文件开头是否有 ef bb bf（BOM），有就用编辑器另存为 “UTF-8 无 BOM” 格式
• 检查 output_buffering 值：php -i | grep output_buffering；若为 On 或数值（如 4096），而脚本中没调用 ob_flush() + flush()，可能卡住输出
• 在脚本最开头加 ob_end_clean(); 可强制清空已有缓冲区（慎用于已有输出逻辑的项目）
• 确保脚本没有在 前输出任何空格、换行或 HTML

Apache 的 AddType 或 SetHandler 配置错误