如何在PhpStorm+Apache2+PHP7.4环境安装配置Xdebug？配置不生效排查

问题核心原因 #

PHP7.4 官方源配套的php7.4-xdebug包默认安装的是 Xdebug 3.x 版本，和 PHP7.2 及更低版本使用的 Xdebug 2.x 配置参数完全不兼容，原有配置已经失效，需要按 Xdebug 3 的规则调整配置。

修复步骤 #

1. 修改php.ini配置
   替换原有 Xdebug 2 的相关配置，改为以下内容（zend_extension后的路径替换为你locate xdebug.so返回的实际路径）：

zend_extension=/你实际的xdebug.so文件路径/xdebug.so
xdebug.mode=debug
xdebug.client_host=127.0.0.1
; 端口需和PhpStorm配置保持一致，Xdebug3默认端口为9003，Xdebug2默认是9000
xdebug.client_port=9003
; 配合Chrome扩展触发调试用trigger，需要自动触发调试可以改为yes
xdebug.start_with_request=trigger
xdebug.idekey=PHPSTORM

2. 调整PhpStorm配置
   打开File > Settings > PHP > Debug，将Xdebug分类下的Debug port修改为和你php.ini中xdebug.client_port一致的数值，比如9003。

3. 验证配置生效
   修改完成后重启Apache服务：

sudo service apache2 restart

新建PHP文件输出phpinfo()，检查Xdebug区块是否显示调试功能已启用，配置参数是否和你设置的一致即可。

内容的提问来源于stack exchange，提问作者fudu