php调试核心工具是xdebug，其配置主要包括设置xdebug.mode、xdebug.client_host与xdebug.client_port。1. 安装xdebug可通过pecl install xdebug或dockerfile添加扩展；2. 配置php.ini启用zend_extension并设定调试模式与端口；3. 重启web服务器使配置生效；4. 在ide（如vs code或phpstorm）中配置launch.json及路径映射；5. 调试时设置断点并启动监听；6. 若连接失败，需检查扩展加载、配置参数、防火墙、路径映射及网络连通性；7. xdebug支持多种模式，如debug、develop、coverage、profile等，按需选用；8. 远程调试需配置client_host为本地ip，并确保网络可达或使用ssh隧道；9. 其他调试工具包括kint、ray、php_codesniffer与blackfire.io，可依需求配合使用。
PHP调试，说白了，就是让代码慢下来，然后我们像医生给病人做检查一样，一步一步地看，到底哪里出了问题。Xdebug，就是那个“听诊器”。
Xdebug配置与使用
Xdebug的配置，说复杂也复杂，说简单也简单。关键在于搞清楚几个核心参数：xdebug.mode、xdebug.client_host、xdebug.client_port。
-
安装Xdebug: 这个步骤根据你的PHP环境有所不同。如果你用的是Docker，可以直接在Dockerfile里加上
pecl install xdebug。如果是本地环境，用pecl install xdebug或者通过你的包管理器安装。立即学习“PHP免费学习笔记（深入）”；
-
配置php.ini: 找到你的
php.ini文件（可以通过phpinfo()函数找到），然后添加或修改以下配置：zend_extension=xdebug.so xdebug.mode=debug xdebug.client_host=127.0.0.1 xdebug.client_port=9000
-
zend_extension=xdebug.so：启用Xdebug扩展。 -
xdebug.mode=debug：设置Xdebug的工作模式为调试。 -
xdebug.client_host=127.0.0.1：指定调试客户端（比如你的IDE）所在的IP地址。通常是本地地址。 -
xdebug.client_port=9000：指定调试客户端监听的端口。
注意： Xdebug 3.x版本和之前的版本在配置上有些差异，主要是
xdebug.remote_enable被xdebug.mode取代了。 -
重启Web服务器: 配置修改后，记得重启你的Web服务器（比如Apache或Nginx）。
-
配置IDE: 接下来，需要在你的IDE（比如VS Code、PhpStorm）里配置Xdebug。
-
VS Code: 安装PHP Debug扩展，然后在
launch.json文件中配置debug选项。{ "version": "0.2.0", "configurations": [ { "name": "Listen for XDebug", "type": "php", "request": "launch", "port": 9000, "pathMappings": { "/var/www/html": "${workspaceFolder}" } } ] }pathMappings这一项非常重要，它告诉Xdebug你的代码在服务器上的路径和本地路径的映射关系。 很多调试不成功的情况都是因为这个配置不对。 PhpStorm: PhpStorm通常会自动检测到Xdebug，你只需要配置Server和Debug configuration。
-
开始调试: 在你的代码中设置断点，然后通过IDE启动调试。当代码执行到断点时，程序会暂停，你就可以查看变量的值、单步执行代码等等。
如何解决Xdebug无法连接的问题？
Xdebug连不上，是调试过程中最常见的问题之一。排查思路通常是这样的：
-
检查Xdebug是否安装成功： 通过
php -v命令查看PHP版本信息，确认Xdebug是否在已加载的扩展列表中。 -
检查php.ini配置： 确保
xdebug.mode、xdebug.client_host、xdebug.client_port配置正确。尤其注意端口号是否被占用。 - 检查防火墙： 确保你的防火墙没有阻止9000端口的连接。
- 检查IDE配置： 确保IDE的调试配置正确，包括端口号、路径映射等。
- 检查网络： 如果你的代码运行在虚拟机或Docker容器中，确保你的主机可以访问虚拟机或容器的IP地址和端口。
-
尝试使用
xdebug_info()函数： 在你的代码中调用xdebug_info()函数，查看Xdebug的配置信息。这可以帮助你确认Xdebug是否正确加载和配置。
Xdebug的不同模式有什么区别？
Xdebug 3.x 引入了xdebug.mode配置项，取代了之前的xdebug.remote_enable等配置。xdebug.mode可以设置为以下几个值：
-
debug：启用调试功能。这是最常用的模式。 -
develop：启用开发辅助功能，比如显示错误信息、堆栈跟踪等。 -
coverage：启用代码覆盖率分析功能。 -
profile：启用性能分析功能。 -
off：禁用Xdebug。
你可以根据需要选择合适的模式。通常情况下，调试代码时使用debug模式，分析性能时使用profile模式。
如何使用Xdebug进行远程调试？
远程调试是指你的代码运行在远程服务器上，而你的IDE运行在本地。要进行远程调试，需要做一些额外的配置：
- 确保远程服务器可以访问你的本地机器： 你需要知道你的本地机器的IP地址，并确保远程服务器可以访问这个IP地址和9000端口。
-
配置
xdebug.client_host为你的本地机器的IP地址： 在远程服务器的php.ini文件中，将xdebug.client_host设置为你的本地机器的IP地址。 - 配置IDE的调试选项： 在IDE中配置调试选项，指定远程服务器的IP地址和端口号。
- 配置SSH隧道（可选）： 如果你的远程服务器位于防火墙后面，你可以使用SSH隧道将远程服务器的9000端口转发到你的本地机器。
远程调试可能会涉及到一些网络配置，需要根据你的实际情况进行调整。
除了Xdebug，还有哪些PHP调试工具？
除了Xdebug，还有一些其他的PHP调试工具，比如：
- Kint: 一个强大的调试工具，可以以更友好的方式显示变量的值。
- Ray: 一个现代化的调试工具，可以将调试信息发送到桌面应用程序。
- PHP_CodeSniffer: 一个代码风格检查工具，可以帮助你保持代码的风格一致。
- Blackfire.io: 一个专业的性能分析工具，可以帮助你找到代码中的性能瓶颈。
选择合适的调试工具取决于你的具体需求。Xdebug是调试代码的首选工具，而其他的工具可以帮助你进行代码风格检查、性能分析等。
