PHP空白页问题排查教程

PHP空白页问题往往并非代码无输出，而是错误被默认静默屏蔽——核心原因在于display_errors关闭、error_reporting未启用E_ALL，导致语法错误、致命错误等完全不可见；排查需分三步：先在代码顶部强制开启错误显示，若仍空白则说明解析期已失败，必须查阅Web服务器错误日志；再验证PHP是否真正执行，通过curl检查响应头和Content-Type，排除服务器未正确配置PHP处理器的可能；最后留意BOM头、隐藏字符等编码陷阱。掌握这套系统化诊断逻辑，就能快速定位并解决99%的PHP空白页顽疾。

PHP 文件打开是空白页，先看错误报告是否开启

空白页几乎总是因为 PHP 报错被静默吞掉，而不是代码真没输出。默认配置中 display_errors 是 Off，error_reporting 也可能被设为 0，导致语法错误、未定义变量、致命错误全不显示，只留一片白。

实操建议：

• 在 PHP 文件最顶部加三行（确保在任何输出之前）：

  ini_set('display_errors', '1');<br>ini_set('display_startup_errors', '1');<br>error_reporting(E_ALL);

• 如果仍空白，说明连这三行都没执行——大概率是语法错误（比如漏了分号、括号不匹配）卡在解析阶段，此时需查 Web 服务器错误日志（如 Apache 的 error_log 或 Nginx + PHP-FPM 的 php-fpm.log）
• 检查 php.ini 中 log_errors = On 和 error_log 路径是否可写，这是唯一能捕获解析期错误的地方

确认 PHP 是否真的在运行，而非被当成纯文本下载或直接返回源码

浏览器打开 .php 文件却是空白，也可能是 Web 服务器根本没把请求交给 PHP 解析器，而是当作静态文件处理了——这时实际返回的是 HTTP 状态码 200，但响应体就是你写的 PHP 源码（只是浏览器不渲染 标签，看起来像空白）。

验证方法：

• 右键「查看网页源码」，如果看到完整的 ，说明 PHP 没生效
• 用 curl -I http://localhost/test.php 查响应头，若 Content-Type: text/plain 或 text/html 但无 PHP 执行痕迹，基本确定是服务器配置问题
• 常见原因：Apache 没加载 libphp.so 或没启用 php_module；Nginx 的 location ~ \.php$ 块缺失或 fastcgi_pass 指向错误；或者文件后缀不在 AddType application/x-httpd-php .php 白名单里

检查输出前是否有不可见字符或 BOM 头

UTF-8 编码的 PHP 文件如果带 BOM（Byte Order Mark），会在 之前输出三个不可见字节，导致「Headers already sent」警告被抑制，页面变空白——尤其常见于 Windows 上用记事本保存的文件。

快速判断和修复：

• 用 VS Code、Notepad++ 或 hexdump -C test.php | head 查看文件开头，如果出现 ef bb bf 就是 BOM
• VS Code 右下角点编码 → 「Save with Encoding」→ 选 UTF-8（不是 UTF-8 with BOM）
• 命令行一键清除：

  sed -i '1s/^\xEF\xBB\xBF//' test.php

• 另存为时务必选「无 BOM 的 UTF-8」，这个细节在团队协作中极易被忽略

echo/print 有输出但页面还是空？检查输出缓冲和重定向逻辑

代码里明明写了 echo 'hello' 却看不到，可能是输出被缓冲、截断，或流程被意外终止。

重点排查点：

• 调用了 ob_start() 但没 ob_end_flush()，或中途 ob_clean() 清空了缓冲区
• 存在 exit、die、return 在输出语句之前（比如数据库连接失败后直接 die，后面就啥也不执行了）
• 用了 header('Location: ...') 但没加 exit，重定向后代码继续执行，可能触发冲突或报错
• 某些框架（如 Laravel）或 CMS（如 WordPress）会拦截并覆盖原始输出，此时需确认是否在正确生命周期钩子中调试（例如 Laravel 的 dd() 要放在路由闭包内，而非全局作用域）

BOM、输出缓冲、服务器配置这三项最容易被跳过，但恰恰是空白页最常卡住的地方。别急着重装环境，先抓响应体、看日志、查编码。

以上就是《PHP空白页问题排查教程》的详细内容，更多关于的资料请关注golang学习网公众号！