PHP脚本错误排查实战技巧

常见的PHP错误类型

写PHP代码时，谁还没碰上过几个报错？有时候只是少了个分号，页面就直接白屏了。最常见的几种错误包括语法错误（Parse error）、运行时错误（Fatal error）、警告（Warning）和通知（Notice）。比如你把 $array['key'] 写成了 $array[key]，没加引号，PHP就会抛出一个通知：未定义常量。

这些错误信息其实都藏在服务器日志或浏览器输出里，关键是要会看。开启错误显示对调试特别有帮助，在开发环境中可以这样设置：

ini_set('display_errors', 1);
error_reporting(E_ALL);

从错误日志入手定位问题

线上环境通常不会直接显示错误，这时候就得查日志。Apache 或 Nginx 的错误日志路径一般在 /var/log/apache2/error.log 或 /var/log/nginx/error.log。如果你的PHP用的是FPM，也可以看看 php-fpm.log 里的记录。

举个例子，用户提交表单后页面卡住不动，打开日志发现一行：
PHP Fatal error: Call to undefined function validate_input() in /var/www/html/process.php on line 45
一眼就能看出是调用了不存在的函数，补上定义或者检查拼写就行。

利用 var_dump 和 die 快速断点

不是所有问题都能靠日志解决，有些逻辑错误需要“打桩”观察数据流向。比如你怀疑某个变量传错了值，可以在关键位置插入：

var_dump($user_data);
die();

这招虽然土，但很管用。看到输出的结构是不是预期的数组，有没有空值混进来，一目了然。处理JSON接口时尤其有用，避免因为类型不符导致后续操作失败。

注意权限与路径问题

有时候脚本跑不起来，并不是代码本身的问题。比如你要往 /uploads/ 目录写文件，但该目录权限是600，PHP进程没权限写入，就会报错“failed to open stream”。这种情况得去终端执行：

chmod 755 /var/www/html/uploads

还有 include 文件加载失败，提示“No such file or directory”，大概率是相对路径写错了。建议统一使用绝对路径，可以用 __DIR__ 来拼接：

require_once __DIR__ . '/config/database.php';

善用 Xdebug 提升效率

如果还在靠 echo 打印调试，那真的慢了半拍。Xdebug 配合 PhpStorm 或 VS Code 能实现断点调试，变量实时查看，调用栈层层展开。安装后在 php.ini 中启用：

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes

配置好之后，请求加上 XDEBUG_TRIGGER=1 参数，就能在编辑器里看到程序一步步执行的过程，复杂循环或递归函数特别适合这种方式。

排查PHP脚本错误，本质上就是练耐心和细节。错误信息从来不会骗人，只要你愿意停下来读一遍，大多数问题都能当场解决。