phpstorm xdebug

2026-10-11 0 次查看

phpstorm xdebug 是排查 PHP 调试环境的核心问题，先检查 Xdebug 扩展是否加载成功，再在 PhpStorm 中配置 CLI 解释器和调试端口，最后用浏览器插件触发调试。

  1. 确认 Xdebug 扩展已安装并启用
    在命令行运行 php -v，查看输出中是否包含 Xdebug 相关行。如果没有，说明扩展未安装或未启用。检查 php.ini 中是否配置了 zend_extension=xdebug（或 xdebug.so / xdebug.dll），并确保路径正确。修改后重启 PHP 服务，再次运行 php -v 确认。
  2. 配置 PhpStorm 的 CLI 解释器
    打开 PhpStorm，进入 Settings（或 Preferences）> Languages & Frameworks > PHP，点击 CLI Interpreter 右侧的浏览按钮。选择已安装 PHP 的路径，PhpStorm 会自动识别版本和 Xdebug 版本。如果识别不到，点击「刷新」或手动选择 PHP 可执行文件。确认后，PhpStorm 会显示 Xdebug 的版本信息。
  3. 设置调试端口和服务器
    在 Settings > Languages & Frameworks > PHP > Debug 中，确认 Xdebug 端口为 9000（Xdebug 2）或 9003（Xdebug 3）。同时检查 php.ini 中的 xdebug.remote_port（Xdebug 2）或 xdebug.client_port（Xdebug 3）是否一致。然后在 Settings > Languages & Frameworks > PHP > Servers 中添加服务器，填写主机名（如 localhost）和端口（如 80），并勾选「Use path mappings」。
  4. 使用浏览器插件或手动启动调试
    推荐安装浏览器扩展（如 Xdebug Helper 或 Xdebug 3 的扩展），在需要调试的页面点击扩展图标，选择「Debug」模式。或者手动在 URL 中添加 XDEBUG_SESSION_START=1 参数。启动后，PhpStorm 会弹出「Incoming Connection」对话框，点击「Accept」即可开始调试。
  5. 验证调试是否生效
    在 PhpStorm 中设置断点，然后访问触发调试的 URL。如果断点被命中，说明配置成功。如果没反应，检查 PhpStorm 的 Debug 控制台是否有错误信息，并确认防火墙允许 PHP 与 PhpStorm 之间的通信。另外，确认 php.ini 中的 xdebug.mode 是否设置为 debug（Xdebug 3 必须设置）。

软件页面：PhpStorm。