PHP页面空白的四大原因及排查步骤:先开启错误显示,再确认文件路径和入口正确,接着检查致命错误并查看日志,最后验证基础环境是否正常运行。

PHP页面空白不是环境没跑起来,而是PHP代码没执行成功。常见原因就几个:错误被屏蔽了、文件放错位置、代码本身出致命错误、或输出被提前触发。下面按排查顺序说清楚。
第一步:打开PHP错误显示
默认很多一键环境会关掉错误提示,导致出错只留白屏。必须先让报错显形:
- 在phpStudy主界面左上角点“软件管理”→“PHP”,点击当前启用版本右侧的“配置文件”按钮,打开 php.ini
- 搜索 display_errors,改成
display_errors = On - 再搜 error_reporting,改成
error_reporting = E_ALL - 保存文件,回到phpStudy界面,重启Apache(或Nginx)服务
- 刷新网页,如果出现红色错误信息,就直接定位问题;如果还是空白,继续往下查
第二步:确认文件路径和入口正确
空白常因根本没访问到PHP文件,或文件不在Web能读取的路径里:
- 检查你访问的URL是否对应真实存在的PHP文件,比如
http://localhost/test.php,就要确保D:\phpstudy_pro\WWW\test.php确实存在 - 注意大小写:Windows下不敏感,但若以后部署到Linux服务器,
Index.php和index.php是两个文件 - 不要双击打开PHP文件——那只是用文本编辑器看源码;必须通过
http://localhost/xxx.php访问才走PHP解析流程 - 如果项目有框架(如ThinkPHP),确认Web服务器的根目录指向的是
public/目录,不是项目根目录
第三步:检查代码是否含致命错误
即使开了错误显示,某些错误仍会导致无任何输出。可临时加一段诊断代码:
立即学习“PHP免费学习笔记(深入)”;
- 在PHP文件最开头(第一行)插入以下三行:
<?php
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
?>
- 检查是否有
require或include的路径错误,比如写成require 'config.php',但实际文件在子目录里 - 查看phpStudy自带的日志:点击Apache/Nginx右侧的“日志”按钮,打开 error.log,里面常有关键线索,如
PHP Fatal error或Primary script unknown - 用记事本或VS Code确认PHP文件编码是 UTF-8 无BOM,带BOM头会导致
session_start()或header()前隐式输出,引发空白
第四步:验证基础环境是否真在运行
有时看似启动了,其实某个组件卡住了:
- 在phpStudy主界面确认Apache(或Nginx)和MySQL状态灯都是绿色,“已启动”
- 浏览器访问
http://localhost,应看到phpStudy探针页或欢迎页;若打不开,说明Web服务根本没响应,要查端口占用(如80被Skype或IIS占了) - 新建一个极简测试文件
info.php,内容只有一行:<?php phpinfo(); ?>,放进WWW目录,访问http://localhost/info.php——能显示PHP配置页,就证明PHP解析器正常工作



















