先简单概述一下这个调试器能干什么:
- 调试协程
- 断点调试
- 断点缓存
- 查看调用栈
- 单步调试
- .....
更多功能敬请期待~包括 PHP8 的支持和集成 IDE 的支持。
下面就来看看如何使用这个调试器:
安装扩展
需要先安装 Yasd 扩展
phpize --clean && \
phpize && \
./configure && \
make clean && \
make && \
make install
设置 php.ini 文件:
zend_extension=yasd.so
查看扩展信息:
php --ri yasd
开始调试
安装成功之后,在需要调试时,增加-e
参数,如
php -e test.php
你就会看到这样的输出
$ php -e test.php
[Welcome to yasd, the Swoole debugger]
[You can set breakpoint now]
>
可用命令
接着就可以来使用一些命令进行调试了,所有命令都支持优先级模糊匹配,如li
、lis
、list
都等于l
,表示查看源码。
查看源码 list
l
设置断点
b 文件的绝对路径 需要断点的行号
默认会将断点信息保存在缓存文件 .breakpoints_file.log
中;
你也可以通过修改 php.ini 指定此文件名,如:
yasd.breakpoints_file=yasd.log
如果缓存文件存在,当启动调试时,文件中的断点信息会被自动加载;
删除断点 delete
d 文件的绝对路径 断点所在的行号
如果设置或者删除断点时,不指定文件绝对路径,默认是当前停留的文件。
运行 run
r
下一步 step over
n
遇到函数的时候,不会进入函数内部
下一步 step into
s
遇到函数的时候,会进入函数内部
跳出当前函数 finish
f
查看调用栈
bt
查看所有断点信息 info
i
继续运行 continue
c
退出 quit
q
打印变量 print
p
变量名字不需要带$
,例如:
p a
p this
p this->prop
查看当前所在的协程 level
le
一些小细节
- 打印断点格式
filename:lineno
如果你是在 IDE 中调试,可以直接点击跳转到对应的文件
- 自动缓存断点信息
默认会将断点信息保存在缓存文件 .breakpoints_file.log
中,如果缓存文件存在,当启动调试时,文件中的断点信息会被自动加载。
- 设置断点和删除断点
如果不指定文件绝对路径,默认是当前停留的文件。
- 自动重复命令
如果不输入命令直接回车,默认是上一条命