配置 Xdebug

检查 Xdebug 安装

1. 按 Ctrl+Alt+S 打开设置，然后选择 PHP。

2. 检查与所选 PHP 解释器关联的 Xdebug 安装：

   1. 在 PHP 页面上，从 CLI 解释器 列表中选择相关的 PHP 安装，并单击字段旁边的 。 列表显示了 PhpStorm 中可用的所有 PHP 安装，请参阅 配置本地 PHP 解释器 和 配置远程 PHP 解释器。

   2. 打开的 CLI 解释器 对话框显示以下内容：

      • 所选 PHP 安装的版本。

      • 与所选 PHP 安装关联的调试引擎（Xdebug 或 Zend Debugger）的名称和版本。 如果未配置调试器，PhpStorm 会显示相应的消息：

        

   或者，打开 安装向导 ，粘贴 phpinfo() 的输出，并单击 分析我的 phpinfo() 输出。 了解有关在 验证调试引擎的配置 中检查 Xdebug安装的更多信息。

定义 Xdebug 行为

1. 在 IDE 设置（Ctrl+Alt+S ）中，选择 Debug 位于 PHP 节点下以打开 Debug 页面。

2. 在 Xdebug 区域中，指定以下设置：

   • 调试端口 ：指定工具与 PhpStorm 通信的端口。

     此端口号必须与 php.ini 文件中指定的端口号相同：

     xdebug.client_port="<the port (9003 by default) to which Xdebug connects>"

     xdebug.remote_port="<the port (9000 by default) to which Xdebug connects>"

     默认情况下，Xdebug 2 监听端口 9000 。 对于 Xdebug 3 ，默认端口已从 9000 更改为 9003 。 您可以通过逗号分隔指定多个端口。 默认情况下， 调试端口 值设置为 9003,9000 ，以使 PhpStorm 同时监听两个端口。

     要使 PhpStorm 接受来自 Xdebug 引擎的任何通过 调试端口 字段中指定端口的传入连接，请选中 可以接受外部连接 复选框。

   • 如果断点在当前行不可用，则解析断点（Xdebug 2.8+） ：选中的复选框启用对 Xdebug 断点解析机制的支持。 在此机制下，调试器会评估 PHP 是否可以为当前行生成内部可执行字节码。 如果断点所指的行上没有这样的代码，则相应的断点无法命中。 Xdebug 将扫描最多 5 行后续代码，停在有可执行代码的行，并将断点定义更新为该行。

   • 未指定路径映射时，在第一行强制中断 ：选中的复选框使调试器在到达并打开未映射到项目中任何文件的文件时立即停止，在 服务器 页面上。 调试器在此文件的第一行停止，并且 检查/更新变量 显示以下错误消息： 无法在服务器上找到文件的本地副本 <服务器上的文件路径> 和一个链接 单击以设置映射。 单击链接以打开 解决路径映射问题 对话框并将问题文件映射到其本地副本。

     清除此复选框时，调试器在到达并打开未映射的文件时不会停止，文件仅被处理，不会显示错误消息。

   • 如果断点位置与源代码不同，则移动断点到解析位置 ：选中的复选框启用断点位置的自动调整，以匹配 Xdebug 实际停止的行。

     请注意，此功能仅在启用 如果断点在当前行不可用，则解析断点（Xdebug 2.8+） 复选框时有效。

   • 当脚本在项目外部时，在第一行强制中断 ：选中的复选框使调试器在到达并打开当前项目外的文件时立即在第一行停止。 清除此复选框时，调试器在打开当前项目外的文件时继续运行。

   • 启用返回函数值调试(Xdebug 3.2+) ：选中的复选框为检查函数返回值添加了额外的调试步骤，这些返回值会立即返回而不存储在中间变量中。

3. 在 外部连接 区域中，指定您希望 PhpStorm 如何处理从未注册为 部署服务器配置的主机和端口接收到的连接。

   • 通过未注册的服务器配置忽略外部连接 ：选中此复选框以使 PhpStorm 忽略从未注册为部署服务器配置的主机和端口接收的连接。 选中此复选框时，PhpStorm 不会尝试自动创建部署服务器配置。

   • 在PHP 脚本中的第一行中断 ：选中此复选框以使调试器在与 PhpStorm 建立连接后立即停止（而不是自动运行直到到达第一个断点）。 或者从主菜单启用 运行 | 在PHP 脚本中的第一行中断 选项。

   • 最大同时连接数 ：使用此微调框限制可以同时处理的外部连接数。

1. 禁用命令行脚本的 Xdebug：

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

   2. 从 PHP 可执行文件 列表中选择相关的 PHP 解释器，然后单击其旁边的 。 在打开的 CLI 解释器 对话框中，单击 在编辑器中打开 链接，位于 配置文件：<path to php.ini> 文件旁边。 关闭所有对话框并切换到打开 php.ini 文件的选项卡。

   3. 在 php.ini 文件中，找到 [xdebug] 部分，并通过在前面添加 ; 来注释以下行：

      ;[xdebug] ;zend_extension = "<path to xdebug extension>"

   4. 打开 CLI 解释器 对话框，并单击 字段旁边的 PHP 可执行文件。 PhpStorm 通知您未安装调试器：

      

2. 要使 PhpStorm 在需要时激活 Xdebug，请在 调试器扩展 字段中，在 其他 区域内指定其路径。 手动输入路径或单击 并在打开的对话框中选择位置。