### 配置 Xdebug 在 PHPStorm 中进行调试 #### 设置 PHP 版本和 Xdebug 扩展 为了确保 Docker 环境中的 PHP 和 Xdebug 正常工作，需确认使用的 PHP 版本以及相应的 Xdebug 版本。通过访问[Xdebug 官方网站][^2]可以获取与当前 PHP 版本匹配的 Xdebug 版本。 #### 修改 `php.ini` 文件配置 Xdebug 参数 编辑位于 Docker 的 PHP 安装目录下的 `php.ini` 文件，添加如下参数来启用并配置 Xdebug： ```ini zend_extension=/path/to/php_xdebug.so xdebug.remote_enable=1 xdebug.remote_handler="dbgp" xdebug.remote_host="host.docker.internal" ; 使用此特殊主机名以便于容器内部连接宿主机上的 IDE xdebug.remote_port=9003 ; 推荐使用更新后的默认端口 9003 xdebug.client_port=9003 ; 同上 xdebug.idekey="PHPSTORM" ; 将 idekey 设定为 PHPSTORM 或其他唯一字符串 xdebug.mode=debug ; 开启调试模式 ``` 注意：对于 Windows 用户，在某些情况下可能需要将 `remote_host` 替换为实际 IP 地址或者尝试 `"localhost"`[^4]。 #### 配置 PHPStorm 进行远程调试 启动 PHPStorm 并进入设置界面 (`File -> Settings`) ，按照以下路径导航至调试服务器配置页面: - **Languages & Frameworks -> PHP** - 添加新的解释器指向本地或远程 PHP 解释器位置。 - **Languages & Frameworks -> PHP -> Debug** - 确认监听端口号(`Debug port`)设为同 `php.ini` 中一致，默认建议采用 9003[^5]。 - **Run/Debug Configurations** - 创建一个新的 “PHP Remote Debug” Profile, 输入之前设定好的 idekey 值 (如 "PHPSTORM")，指定目标文件映射关系以关联项目源码与 Web 根目录之间的对应关系[^1]。 #### 测试环境搭建完成情况 安装浏览器插件 [Xdebug Helper](https://chrome.google.com/webstore/detail/xdebug-helper/eadndfjplgieldjbigjakmdgkmoaaaoc)[^3], 可方便地切换不同开发工具间的断点触发条件；当准备就绪时开启该扩展程序并将 IDE Key 切换成刚才定义的那个值 ("PHPSTORM"). 最后一步是在 PHPStorm 中激活监听状态（绿色虫子图标），随后发起 HTTP 请求测试整个流程是否顺畅运行。