Skip to main content

Swoole如何使用 Xdebug 进行单步调试(转载)

在 PHP-FPM 中使用 Xdebug 的人应该不少,而在 Swoole 中使用 Xdebug 的人还是很少的,原因是 Swoole 扩展明确说明了和 Xdebug 扩展冲突 不过好在我们社区成员给力,提供了一个 Sdebug ,在此我们应该感谢 @mabu233 和 @huanghantao 进行了兼容,让 Xdebug 可用于 Swoole 环境进行断点、调试 之前在 Swoole 文档中补充了 Sdebug 的安装,同样的 Sdebug 的 README 也进行了修改介绍如何安装,不过都是简单说明如何成功加载扩展,没有详细说明配置

tip

先说一下如何安装 Sdebug

git clone git@github.com:swoole/sdebug.git -b sdebug_2_9 --depth=1
cd sdebug
phpize
./configure
make clean
make
make install

步骤很简单,就是 clone 源码,进入目录然后编译 如果你的 PHP 是通用安装,没有修改默认位置等等,也可以直接运行目录下的脚本:

./rebuild.sh

如果你的 phpize 不是默认路径的话,请使用绝对路径;同样的 php-config 需要使用--with-php-config=加上你的绝对路径 编译成功后需要在 php.ini 加载扩展

tip

编译完成后生成的 so 文件名还是 xdebug

查看是否加载成功

php --ri sdebug

别走,还没完,还需要一些其他的配置,不然你去断点会发现不起作用 我们还需要在 php.ini 中加入这几个配置项

xdebug.remote_enable=1
xdebug.remote_autostart=1
xdebug.remote_host=localhost
xdebug.remote_port=8000
xdebug.idekey="xdebug"

(批注: 大概是这样)

zend_extension="xdebug.so"
...
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
[xdebug]
xdebug.remote_enable=1
xdebug.remote_autostart=1
xdebug.remote_host=localhost
xdebug.remote_port=9100
xdebug.idekey="xdebug"
...

一个配置难倒英雄汉,很多人在使用 Sdebug 的时候就会遇到需要这样问题,不起作用,就吐槽不好用,实际上是你的姿势不对,配置项没加或者加错了 需要配合 PhpStorm 的话,还需要设置一下 PhpStorm 的配置 Preferences | Languages & Frameworks | PHP | Debug 1 是为了我们不加断点的时候,自动给第一行断点 2 是修改配置的remote_port端口

Preferences | Languages & Frameworks | PHP | Servers 添加一个服务 紧接着在右上角这里添加一个调试,选择 PHP Remote Debug server 选择我们刚才创建的 server,IDE key 就填我们 php.ini 中配置的xdebug

然后我们来试验一波,看看好不好使

先来一个简单的 TCP Server

//创建Server对象,监听 127.0.0.1:9501 端口
$server = new SwooleServer('127.0.0.1', 9501);
//监听连接进入事件
$server->on('Connect', function ($server, $fd) {
echo "Client: Connect.n";});
//监听数据接收事件
$server->on('Receive', function ($server, $fd, $from_id, $data) {
var_dump($data);
$server->send($fd, "Server: " . $data);
});
//监听连接关闭事件
$server->on('Close', function ($server, $fd) {
echo "Client: Close.n";});
//启动服务器
$server->start();

点击右上角的绿色虫子进入 Debug 状态,启动我们的服务,会发现自动断在了第 4 行创建 Server 对象的地方 然后下一步下一步...

start 之后我们使用 telnet 进行连接,发送一个消息,断点就进入到 Connect 这里,然后我们再下一步,终端才会输出Connect

紧接着我们会到 var_dump 的地方,就可以看到 $data 的值是11111rn 然后来一个 HTTP Server

$http = new SwooleHttpServer('0.0.0.0', 9501);
$http->on('request', function ($request, $response) {
var_dump($request->server);
$response->header("Content-Type", "text/html; charset=utf-8");
$response->end("<h1>Hello Swoole. #".rand(1000, 9999)."</h1>");
});
$http->start();

这里需要在访问时加上一个XDEBUG_SESSION_START参数或者在 Cookie 中添加也可以 浏览器访问http://127.0.0.1:9501/?XDEBUG_SESSION_START=xdebug

也是可以断点调试的 框架的使用也是同理的,至于其他的什么和 docker 一起使用等等自己研究吧...

这里放一张调试 Hyperf 的截图 还有一个 Tips,把右上角的电话图标选择为上图那样,会在命令行启动服务时自动调起 Debug 服务

我有话要说

这个用过了, 太卡了, 个人还是建议用yasd,效果样,配置得当还是很快的。