调试能力往往比写代码能力更影响效率。同样一个 bug,有人半小时定位,有人耗一整天。差别不在聪明程度,而在是否有系统的方法和顺手的工具。
第一层:把错误显示出来
开发环境先把这三项配好,很多问题会自己暴露:
<?php
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);
// 或者在 php.ini 里
// display_errors = On
// error_reporting = E_ALL
// log_errors = On
// error_log = /var/log/php_errors.log
第二层:结构化输出
var_dump 适合看类型,print_r 适合看结构,但两者都会打乱页面。更好的方式是输出到日志或直接中断:
<?php
function dd($data) {
echo '<pre style="background:#111;color:#0f0;padding:12px;font-size:13px;">';
var_dump($data);
echo '</pre>';
exit;
}
// 输出到日志文件,不污染页面
error_log('[debug] order=' . json_encode($order, JSON_UNESCAPED_UNICODE));
// 输出到浏览器控制台(适合 AJAX 接口)
function console_log($data) {
echo '<script>console.log(' . json_encode($data, JSON_UNESCAPED_UNICODE) . ');</script>';
}
第三层:断点调试
Xdebug 装好之后,配合 VS Code 或 PhpStorm 可以单步执行、查看变量、追踪调用栈。配置要点:
; php.ini
[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=trigger
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.idekey=VSCODE
不要在生产环境开 xdebug.mode=debug,性能损耗非常明显。生产环境用 xdebug.mode=off,需要采样分析时临时开 profile。
第四层:日志与链路
线上问题无法断点,只能靠日志。建议至少记录:请求路径、关键入参、耗时、异常堆栈、用户标识。用 Monolog 之类的库做结构化日志,比 file_put_contents 拼接字符串好维护得多。
一个排查思路
遇到问题时,先问三个问题:能不能稳定复现?输入是什么?预期与实际差在哪一步?把范围二分,比盲目加 dump 快得多。如果五分钟还没头绪,先去看错误日志,答案往往就在里面。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。