下面三个现象几乎每个 PHP 开发者都遇到过。它们的共同点是:页面看起来什么都没说,但日志里其实有答案。养成先看日志的习惯,能省掉大量猜测。
一、白屏(HTTP 200 但无内容)
白屏通常意味着脚本执行中断,但错误没有显示。按顺序检查:
- 打开
display_errors,或用php -l检查语法; - 看 PHP 错误日志(宝塔一般是
/www/wwwlogs/php-fpm.log或站点 error.log); - 确认不是
exit、die被提前触发; - 如果用了 OPcache,清一次缓存再试。
常见原因是内存超限(Allowed memory size exhausted)或调用了不存在的函数——后者在 PHP 7 之后是 Error 而非 Fatal error,某些老框架的错误处理抓不到。
二、500 Internal Server Error
500 是服务器层面的错误,说明 PHP 进程崩了或配置有问题。排查顺序:
- 语法错误:
php -l file.php逐个大改过的文件检查; - 权限问题:文件属主不对,PHP-FPM 读不到,日志里是
Permission denied; - .htaccess / 伪静态:规则写错导致循环重写;
- 扩展缺失:用了
mysqli但没装扩展。
# 快速定位
tail -n 50 /www/wwwlogs/你的域名.error.log
tail -n 50 /www/server/php/71/var/log/php-fpm.log
php -l /www/wwwroot/站点/index.php
三、Headers already sent
错误信息会明确告诉你”输出已经在第 X 行开始”。三种典型原因:
| 原因 | 表现 | 处理 |
|---|---|---|
| 文件带 BOM | 第 1 行就报 | 转成 UTF-8 无 BOM |
?> 后有空格或空行 |
报在文件末尾 | 纯 PHP 文件去掉结束标记 |
| 前面有 echo / 空行输出 | 报在实际输出行 | 把 header 调用提前,或用 ob_start |
<?php
// 兜底方案:在文件最开头开启输出缓冲
ob_start();
// ... 业务逻辑
header('Location: /login');
exit;
一个通用习惯
把 error_reporting(E_ALL) 和 log_errors=On 固定在开发环境,并且每天开工前先 tail 一下日志。很多问题在变成故障之前,日志里已经有征兆了。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。