1、安装Xdebug扩展

pecl install xdebug

查看php配置文件位置

phpinfo() 或直接运行php_ini_loaded_file()

配置php.ini，添加xdebug

zend_extension=Xdebug的path/xdebug.so
xdebug.mode=debug
xdebug.idekey=PHPSTORM
xdebug.client_host=host.docker.internal

host.docker.internal 它会自动解析为主机的内部地址

重启php-fpm

重新查看phpinfo如下

2、下载并安装 DBGp 代理

通过 Xdebug 代理 (DBGp) 服务器配置多用户调试

下载dbgpProxy可执行文件

Xdebug: Downloads

添加执行权限（mac版本）

chmod a+x ./dbgpProxy-macos

执行

./dbgpProxy-macos -i 30.xx.xx.239:9999 -s 127.0.0.1:9003

-i用于侦听 IDE（客户端）连接的主机和端口

-s侦听调试器引擎（服务器）连接的主机和端口

3、配置PHPStorm

打开Preferences->Languages & Frameworks->PHP->Debug，配置Xdebug->Debug port

端口号要与phpinfo中xdebug.client_port一致

打开Preferences->Languages & Frameworks->PHP->Debug->DBGp Proxy，修改配置

IDE key与phpinfo中xdebug.idekey一致

Host、Port与dbgpProxy-macos -i参数一致

Tools->DBGp Proxy->Register IDE 服务器注册凭据，并确认连接

打开Preferences->Languages & Frameworks->PHP->Servers，配置如下

查看docker挂载目录

docker inspect --format '{{ .HostConfig.Binds }}' <容器名>

Absolute path on the server路径为docker容器中web目录，与本地php项目路径对应

打开debug监听

 

4、浏览器添加xdebug扩展

https://chrome.google.com/webstore/detail/xdebug-helper/eadndfjplgieldjbigjakmdgkmoaaaoc

配置扩展

5、测试Xdebug

在php文件中打断点请求即可