空白页主因是PHP错误被静默忽略,需开启display_errors、display_startup_errors并设error_reporting(E_ALL);若仍空白则查服务器错误日志;还可能是Web服务器未解析PHP而直接返回源码。

PHP 文件打开是空白页,先看错误报告是否开启
空白页几乎总是因为 PHP 报错被静默吞掉,而不是代码真没输出。默认配置中 display_errors 是 Off,error_reporting 也可能被设为 0,导致语法错误、未定义变量、致命错误全不显示,只留一片白。
实操建议:
- 在 PHP 文件最顶部加三行(确保在任何输出之前):
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
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免费学习笔记(深入)”;
- 右键「查看网页源码」,如果看到完整的
,说明 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()要放在路由闭包内,而非全局作用域)











