PhpStorm 2026.2 Help

在 Just-In-Time 模式下调试

PhpStorm 支持在 即时 (JIT)模式下使用 Xdebug,因此它不会一直附加到您的代码,而仅在发生错误或抛出异常时连接到 PhpStorm。 根据所使用的 Xdebug 版本,此操作模式通过以下设置切换:

该模式可用于调试命令行脚本和 Web 服务器调试。

配置 Xdebug 以使用即时模式

根据您是要调试命令行脚本还是使用 Web 服务器,请使用以下场景之一。

命令行脚本

对于调试命令行脚本,请将自定义 -dxdebug.remote_mode=jit (适用于 Xdebug 2)或 -dxdebug.start_upon_error=yes (适用于 Xdebug 3)指令指定为 附加配置选项:

  1. 在 设置 对话框 (Ctrl+Alt+S) 中,前往 PHP。

  2. 从 PHP 可执行文件 列表中选择相关的 PHP 解释器,然后单击其旁边的 “浏览”按钮。

  3. 在打开的 CLI 解释器 对话框中,单击 “浏览”按钮 字段旁边的 配置选项 ,在 附加项 区域中。

  4. 在打开的 配置选项 对话框中,单击 "添加"按钮 以添加新条目。

    在 配置指令 字段中输入 xdebug.start_upon_error ,在 Value 字段中输入 yes。

    在 配置指令 字段中输入 xdebug.remote_mode ,在 Value 字段中输入 jit。

    单击 确定 后,您将返回到 CLI 解释器 对话框,其中 配置选项 字段显示 -dxdebug.remote_mode=jit (适用于 Xdebug 2)或 -dxdebug .start_upon_error=yes (适用于 Xdebug 3)。

Web 服务器调试

  1. 在主菜单中,进入 运行 | Web 服务器调试验证.

  2. 在打开的 验证远程环境 中,选择 Web 服务器以验证调试器。

    • 选择 本地 web 服务器或共享文件夹

      用于存放验证脚本的目录

      在此字段中,指定服务器文档根目录下将创建验证脚本的文件夹的绝对路径。 对于 Inplace 类型的 Web 服务器,文件夹位于项目根目录下。

      该文件夹必须通过 HTTP 可访问。

      指向包含脚本的目录的 URL

      在此字段中,输入将创建验证脚本的文件夹的 URL 地址。 如果项目根目录映射到通过 HTTP 可访问的文件夹,您可以指定项目根目录或其下的任何其他文件夹。

    • 选择 远程 web 服务器

      用于存放验证脚本的目录

      在此字段中,指定服务器文档根目录下将创建验证脚本的文件夹的绝对路径。 该文件夹必须通过 HTTP 可访问。

      部署服务器

      在此字段中,指定访问目标环境的 Local Server 或 Remote Server 类型的服务器访问配置。 有关更多信息,请参阅 连接到 Web 服务器。

      从列表中选择一个配置,或在 Deployment dialog 中单击 浏览 “浏览”按钮。

  3. 单击 验证 ,让 PhpStorm 创建一个验证脚本,将其部署到目标远程环境并在那里运行。

  4. 打开报告为已加载并与 Xdebug 关联的 php.ini 文件。

  5. 在 php.ini 文件中,找到 [xdebug] 部分。

    将 xdebug.start_upon_error 的值从默认 默认 更改为 yes。

    将 xdebug.remote_mode 的值从默认 req 更改为 jit。

调试会话

设置断点并启动调试会话,如 启动调试会话或 使用 PHP 网页调试配置进行调试 中所述。

Xdebug 在以下两种情况下连接到 PhpStorm:

  • 当发生错误时。 在这种情况下,Xdebug 会在错误条件之后的那一行停止。 原因是 PhpStorm 必须先运行出错的代码,才能知道有问题。

  • 当抛出异常时。 如果异常被处理,Xdebug 会在 catch 块的第一行(如果有)或 finally 块处中断。

2026年 7月 14日