手把手完成mac下配置phpstorm的xdebug3

本机在phpstorm下启动服务，比较容易，但是要调试就要配置xdebug。

环境

PhpStorm 2021.3.2
macOS Monterey 12.0.1 (21A559)
PHP 7.2.0
xdebug 3.1.5
本地server地址：localhost:9011

修改php.ini

PHP安装目录

/usr/local/Cellar/[email protected]/7.2.34_4/bin/php

PHP配置目录php.ini：

vim /usr/local/etc/php/7.2/php.ini

在尾部追加：

[Xdebug]
zend_extension = "/usr/local/Cellar/[email protected]/7.2.34_4/pecl/20170718/xdebug.so"
xdebug.remote_handler="dbgp"
xdebug.client_host=localhost
xdebug.client_port=9001
xdebug.idekey=phpstorm
xdebug.start_with_request=yes
xdebug.mode=debug 

其中xdebug.so扩展可以通过

pecl install xdebug 

来安装。

验证是否安装扩展xdebug成功

[email protected]:[pc]/usr/local/etc/php/7.2 php -i | grep -i xdebug
    with Xdebug v3.1.5, Copyright (c) 2002-2022, by Derick Rethans
xdebug
Support Xdebug on Patreon, GitHub, or as a business: https://xdebug.org/support
             Enabled Features (through 'xdebug.mode' setting)             

如果出现以上信息，就算是支持了。
有的同学可以通过phpinfo信息来查看，也是可以的。
通过php查看扩展的方式也可以看到xdebug。

> php -m 

[Zend Modules]
Xdebug
Zend OPcache

phpstorm的修改

在php->debug 下修改

debug端口需要跟php.ini一致

这里我使用的是9001，因为9000和fpm的 默认端口冲突，会提示被占用。

image.png

这里使用dbgp配置，注意照着php.ini的配置来写。localhost和127.0.0.1有时候是等效的，这里建议你还是区分一下，没有必要去掉这种坑里。

image.png

在php->servers下添加，注意host和port和debugger的写法，严格一致。name字段无所谓，这里只是告诉phpstorm，那些域名的服务应该用什么debugger工具，不配置就无法启用debugger。

image.png

最后在debug configurations里面添加内建web server，注意host和port不要写错。
document root下需要有index.php文件，不然路径就是非法的。

image.png

最后在电话按钮这里点击，开始接受debug信息。并开始启动服务。

image.png

发送请求时，会看到run里面的打印信息。如果代码中添加有断点，调用接口会在断点处停止。

image.png

debug控制

发送请求时，需要添加GET参数，XDEBUG_SESSION_START=phpstorm，但我在实测过程中发现，只要存在断点，即使请求没有添加XDEBUG_SESSION_START参数，你点击的是run运行，而不是debug运行，依然是可以停在断点处的。如果你把php.ini中的xdebug.start_with_request=yes改为no，就会停止debug了，不会再停止。
有的人说可以安装chrome插件来自定添加断点参数，我觉得你也可以试试：

image.png

验证

如果你没有在断点处停止，那么你可以使用验证功能来检查，提示信息会帮助你解决问题。

image.png

点击这个validae来验证是否配置ok。

image

理想效果就是这样，全部都是勾。

xdebug选项介绍

1.条件触发调试

xdebug.trigger_value=cookie_value_trigger
xdebug.start_with_request=trigger

如果你在php.ini如此配置，则可触发断点运行。
postman发送请求时，需要配置（当然，COOKIE参数、GET参数或者POST参数传递XDEBUG_TRIGGER=cookie_value_trigger都是等效的）：

打开断点

2.单元测试触发调试

通过环境变量打开单步调试

配置内容为：XDEBUG_TRIGGER=cookie_value_trigger

其他说明

很多人配置的是

xdebug.remote_host=localhost
xdebug.remote_port=9001

这个是xdebug2的配置方法，而本文是xdebug3。