之前学 Java 的时候,一直使用 IDE 的 console 控制台进行调试。后来搞 PHP 后,习惯在代码里面 echo 和 exit,然后在浏览器刷新看效果,把单步调试、变量值查看等常用的调试方式给忘了。其实通过 IDE 集成的控制台进行调试更高效。
下面的示例都是基于 Windows 下的 LNMP 环境,其安装方式可以 参考这里。
常用调试方式
通过浏览器打印信息进行调试
方法
在代码中添加 echo、var_dump、print_r 和 exit,在浏览器中查看输出。
优缺点
优点:
- 简单,使用方便,不用安装插件
- 对于自己写的代码,或比较熟悉的框架,可以这么用
缺点:
- 对于多分支逻辑,需要加很多代码或尝试多次
- 对于不熟悉的逻辑,无法反映出完整的执行流程。
- 有可能将调试语句遗漏在项目中
- 无法单步执行
技巧
调试时,为了格式化输出变量,往往需要在项目中实现自己的 dump()
函数。利用 Composer,可以全局安装 symfony/var-dumper
包中的 dump()
函数,使所有项目都可以使用,而无需改动项目。
- 全局安装
symfony/var-dumper
包:
默认会安装到${HOME}/.config/composer
目录
composer global require symfony/var-dumper
- 修改
php.ini
文件,执行 PHP 代码之前先 include 指定的文件
auto_prepend_file = ${HOME}/.config/composer/vendor/autoload.php
使用 Xdebug 进行调试
XDebug 是 C/S 结构,其中 Client 是 PHP 中安装的 Xdebug,Server 是 IDE 中安装的插件,使用 DBGP 协议通信。PHP 运行脚本时,通过 Xdebug 插件向 IDE 发送调试信息,并接收 IDE 发过来的控制信号。
需要为 PHP 安装并开启 Xdebug,然后设置 IDE 的 Xdebug 插件,使二者可以通信。
优缺点
- 支持单步调试和任意变量值的获取
- 配置复杂,需要 IDE 安装插件
- 支持跟浏览器的配合,需要请求中携带
XDEBUG_SESSION_START
参数
Web App 调试
对于 web 应用,要开启 Xdebug 调试模式,必须在浏览器发送的请求中添加额外的标志。可以在 GET/POST/Cookie 参数中添加 XDEBUG_SESSION_START=session_name
,这样 Xdebug 就明白这个请求需要调试,去连接 IDE。
但每次手工设置也很麻烦,有两种方式简化操作:
- 使用 IDE 提供的方式。对于 PhpStorm,参考 Debugging PHP Web Applications with Run Debug Configurations。使用时需要配置好 IDE 中的 Web Server,然后设置一个 PHP Web Application,点击 Debug 按钮开始调试,这时 IDE会自动打开浏览器并输好网址,并添加
XDEBUG_SESSION_START=session_name
。 - 使用浏览器插件,打开插件的调试开关后,插件可以自动在请求中带上对应的 Cookie。对于 Chrome 可以安装 Xdebug helper。
通过 console 终端进行调试(CLI 方式)
对于非 web 应用,例如定时任务或单元测试,可以直接在控制台进行调试。
PhpStorm 中通过 Alt+F12
快捷键打开命令行终端。但是因为 IDE 中只能显示一个终端,在开启调试后的调试终端会覆盖命令行终端,所以还是单独开一个命令行终端吧(Windows 下可以使用 DOS 窗口或 PowerShell)。
方法及原理
web 应用通过 GET/POST/Cookie 参数标志调试请求,而非 web 应用则通过在命令行终端设置环境变量来开启调试。
两步:
- 设置环境变量
XDEBUG_CONFIG="idekey=session_name"
,这个 idekey 需要跟php.ini
中 Xdebug 部分设置的 idekey 一样。 - 在命令行终端执行脚本。执行时会唤起 IDE 的 debug 终端,可以单步调试,输出结果实时显示在命令行终端。
IDE通常提供快捷操作,对于 PHPStorm 可以参考 Debugging PHP CLI scripts with PhpStorm。
通过 IDE 启动调试后,IDE 会启动 Xdebug 插件监听某个端口(PhpStorm 默认是 9000,但是这跟 PHP-FPM 冲突了,可以改为 9001),获取 PHP 服务器返回的调试信息。
D:lnmpphp72php.exe -dxdebug.remote_enable=1 -dxdebug.remote_mode=req -dxdebug.remote_port=9001 -dxdebug.remote_host=127.0.0.1 D:lihongfengworkspaceuntitledindex.php
设置、查看和释放环境变量
- Linux
export XDEBUG_CONFIG="idekey=session_name" // 设置环境变量
echo $XDEBUG_CONFIG // 查看环境变量
unset XDEBUG_CONFIG // 删除环境变量
- Windows
set XDEBUG_CONFIG="idekey=session_name" // 设置环境变量
echo %XDEBUG_CONFIG% // 查看环境变量
set XDEBUG_CONFIG // 查看环境变量
set XDEBUG_CONFIG= // 删除环境变量