页面空白极可能是PHP错误被静默抑制或脚本未执行到输出阶段：一、在脚本顶端插入三行错误显示指令；二、检查PHP是否启用；三、验证Web服务器配置；四、排除UTF-8 BOM干扰。
如果您运行PHP脚本后页面完全空白，既无HTML输出也无错误提示，则极可能是PHP错误被静默抑制或脚本未执行到输出阶段。以下是系统性排查与恢复可见错误信息的操作步骤：
一、强制启用运行时错误显示
该方法绕过php.ini限制，在脚本最顶端插入三行指令，确保在任何输出前执行，可立即暴露Parse Error、Fatal Error等关键问题。
1、打开空白页对应的PHP文件（如index.php、create.php等）；
2、在文件第一行、严格位于的位置，插入以下代码：
立即学习“PHP免费学习笔记（深入）”；
3、保存文件并刷新浏览器；
4、若页面仍为空白，说明错误发生在解析阶段（如语法错误导致
二、检查PHP错误日志路径与写入权限
当display_errors关闭或配置失效时，所有错误均会写入error_log指定的文件。该日志是唯一能捕获解析期错误（如Missing semicolon、Unexpected token）和静默终止的可靠来源。
1、新建一个临时文件info.php，内容为，通过浏览器访问，查找"error_log"和"Loaded Configuration File"两项值；
2、确认error_log路径（如/var/log/php_errors.log）存在且Web服务器运行用户（如www-data、apache、nginx）对该文件或其所在目录具有写权限；
3、终端执行：sudo chown www-data:www-data /var/log/php_errors.log && sudo chmod 644 /var/log/php_errors.log（路径依实际调整）；
4、在空白页脚本顶部添加error_log("DEBUG: script started", 0);，刷新页面后执行：tail -n 20 /var/log/php_errors.log，观察是否写入调试标记及真实错误。
三、验证PHP是否真正解析执行
空白页可能源于Web服务器未将.php请求交由PHP引擎处理，而是作为纯文本返回——此时浏览器不渲染PHP标签，源码不可见，视觉上即为空白。
1、右键空白页 → “查看网页源代码”，若看到完整未执行的代码，则PHP未生效；
2、使用curl命令验证响应头：curl -I http://localhost/your-script.php；
3、若返回Content-Type: text/plain或Content-Type: text/html且无X-Powered-By: PHP字段，说明Nginx/Apache配置缺失；
4、Apache检查httpd.conf或.htaccess中是否存在AddType application/x-httpd-php .php；Nginx检查server块内是否有location ~ \.php$ { ... fastcgi_pass ... }配置段。
四、排除UTF-8 BOM与不可见字符干扰
BOM（Byte Order Mark）会在
1、用VS Code打开空白页PHP文件，右下角查看编码格式，若显示“UTF-8 with BOM”，则必须转换；
2、点击编码 → “Save with Encoding” → 选择UTF-8（不含BOM）；
3、或使用命令行清除：在Linux下执行sed -i '1s/^\xEF\xBB\xBF//' your-script.php；
4、同时检查文件开头是否有多余空行、空格、制表符，删除所有
五、启用Xdebug进行断点追踪
当错误隐藏于深层调用链、异常被try/catch吞没或内存溢出导致进程崩溃时，静态日志与错误显示均失效，需借助Xdebug实现运行时控制流可视化。
1、终端执行php -m | grep xdebug，确认扩展已加载；
2、若未启用，在php.ini中添加：zend_extension=xdebug.so（Linux/macOS）或zend_extension=php_xdebug.dll（Windows）；
3、追加配置：xdebug.mode=debug; xdebug.start_with_request=yes; xdebug.client_host=127.0.0.1; xdebug.client_port=9003；
4、重启Web服务与PHP-FPM；
5、在VS Code中安装PHP Debug插件，设置断点后启动调试会话，访问URL即可在断点处暂停并查看变量、堆栈与执行路径。
