Xdebug与PhpStorm报错：‘未加载调试扩展’问题排查

兄弟，我之前踩过Wamp+PhpStorm+Xdebug的同款配置坑，尤其是多PHP版本对应多个php.ini的问题，给你一步步捋清楚怎么解决：

别懵，这三个文件各司其职：

• wamp64\bin\apache\apache2.4.23\php.ini：浏览器访问Web项目时生效的配置，也就是Apache加载PHP时用的文件
• wamp64\bin\php\php7.0.10\php.ini / wamp64\bin\php\php5.6.25\php.ini：这俩是对应PHP版本的命令行(CLI)模式配置文件，比如你在终端跑PHP脚本时会读取它

不管是Web调试还是CLI调试，都得让Xdebug生效，所以三个文件都要配置：

1. 先确认你用的PHP版本对应的Xdebug扩展路径，比如PHP7.0.10的扩展一般在wamp64/bin/php/php7.0.10/ext/下，文件名类似php_xdebug-xxx-7.0-vc14-x86_64.dll
2. 打开每个php.ini，在文件末尾粘贴以下配置（Xdebug 2.x版本示例，要是用Xdebug 3.x参数不一样，注意区分）：

zend_extension = "d:/wamp64/bin/php/php7.0.10/ext/php_xdebug-2.5.5-7.0-vc14-x86_64.dll"
xdebug.remote_enable = 1
xdebug.remote_host = 127.0.0.1
xdebug.remote_port = 9000
xdebug.remote_autostart = 1
xdebug.idekey = PHPSTORM

划重点：如果是Xdebug 3.x，配置要改成这样：

zend_extension = "你的Xdebug扩展路径"
xdebug.mode = debug
xdebug.client_host = 127.0.0.1
xdebug.client_port = 9003
xdebug.start_with_request = yes

配置CLI解释器 #

1. 打开PhpStorm，走路径File > Settings > Languages & Frameworks > PHP（Mac是PhpStorm > Preferences）
2. 点击CLI解释器右侧的...按钮，新增一个解释器：
   • 选From Local...，找到Wamp对应的PHP目录，比如wamp64/bin/php/php7.0.10
   • 系统会自动读取这个目录下的php.ini，你可以在解释器详情里看到Xdebug是否被识别（有Xdebug版本信息就说明没问题）
3. 把这个解释器设为默认，或者在当前项目的配置里指定它

配置Web服务器调试 #

1. 还是在Settings > Languages & Frameworks > PHP > Servers
2. 新增服务器：名称随便填（比如LocalWamp），主机填localhost，端口用Wamp Apache的默认端口（一般是80），勾选Use path mappings，把你本地项目的目录（比如D:/wamp64/www/my-project）映射到服务器上的对应路径（比如/my-project）
3. 再去Settings > Languages & Frameworks > PHP > Debug，确认Xdebug的端口和你php.ini里写的完全一致（9000或9003）

• Web端验证：在项目根目录建个phpinfo.php，内容写<?php phpinfo(); ?>，浏览器访问localhost/my-project/phpinfo.php，搜索Xdebug，能看到完整的Xdebug配置段就说明Web端生效了
• CLI端验证：打开命令行，切换到对应PHP目录（比如cd wamp64/bin/php/php7.0.10），运行php -v，如果输出里有with Xdebug vx.x.x的字样，CLI端就没问题了

• 三个php.ini都要改！别只改一个，Web用Apache下的，CLI用对应PHP版本下的，漏一个都出问题
• Xdebug版本必须和PHP版本匹配，Wamp其实自带了对应版本的Xdebug，直接用自带的最稳妥，别自己乱下
• PhpStorm的调试端口一定要和php.ini里的一致，Xdebug3默认是9003，Xdebug2默认是9000，搞混了就连不上

内容的提问来源于stack exchange，提问作者J.BizMai