在本地Windows/XAMPP环境下配置PhpStorm的Xdebug CLI调试

一、配置Xdebug（修改php.ini） #

1. 打开XAMPP控制面板，确认当前PHP版本，确保Xdebug版本与PHP匹配（Xdebug 3.x适配PHP 7.4+，XAMPP默认自带对应版本的Xdebug）
2. 找到XAMPP的PHP配置文件：C:\xampp\php\php.ini，用文本编辑器打开
3. 在文件末尾添加/修改以下Xdebug配置：

   zend_extension = "C:\xampp\php\ext\php_xdebug.dll"
   xdebug.mode = debug
   xdebug.client_host = localhost
   xdebug.client_port = 9003
   xdebug.start_with_request = yes
   xdebug.idekey = PHPSTORM
   

   注意：php_xdebug.dll的路径要与XAMPP实际文件路径一致，默认就是上述格式

4. 保存文件后，重启XAMPP的Apache服务（确保配置生效）

二、PhpStorm中配置PHP解释器与调试参数 #

1. 打开PhpStorm，依次进入 File > Settings > PHP（Windows/Linux）或 PhpStorm > Settings > PHP（Mac）
2. 点击「CLI Interpreter」右侧的「...」，选择「+」>「Local」，添加XAMPP的PHP执行文件：C:\xampp\php\php.exe，PhpStorm会自动识别Xdebug，确认「Debugger」栏显示Xdebug版本信息
3. 进入 Settings > PHP > Debug，确认Xdebug的「Debug port」为9003（与php.ini配置一致），勾选「Can accept external connections」
4. 点击「Apply」保存配置

三、创建Drush命令的调试配置 #

1. 点击PhpStorm右上角的「Add Configuration...」，选择「+」>「PHP Script」
2. 填写调试配置信息：
   • Name：自定义名称（比如「Drush 迁移调试」）
   • CLI Interpreter：选择刚才配置的XAMPP PHP解释器
   • Script path：填写Drush执行文件路径：
     • Composer本地安装：你的Drupal项目根目录\vendor\bin\drush.bat
     • 全局安装：C:\Users\你的用户名\AppData\Roaming\Composer\vendor\bin\drush.bat
   • Arguments：填写要调试的Drush命令，比如 migrate:import --group=自定义迁移组
   • Working directory：选择你的Drupal项目根目录
3. 点击「Apply」保存配置

四、启动调试 #

1. 在Drupal代码中设置断点：比如打开迁移插件文件（modules/custom/你的模块/src/Plugin/migrate/source/XXX.php），在需要调试的行左侧点击添加红色断点
2. 点击PhpStorm右上角的「Start Listening for PHP Debug Connections」按钮（电话图标，变绿即为开启状态）
3. 点击调试配置旁的「Debug」按钮（虫子图标），启动调试，此时PhpStorm会自动触发断点，可使用步进、变量查看等功能调试

常见问题排查 #

• 断点未触发：检查php.ini配置是否正确，PhpStorm监听是否开启，调试配置的CLI解释器是否为XAMPP的PHP（终端执行php -v确认显示Xdebug）
• 路径问题：若Script path或Working directory包含空格，需用双引号括起
• Xdebug识别失败：重新下载对应PHP版本的Xdebug替换php_xdebug.dll

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