配置 Xdebug

检查 Xdebug 安装

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

2. 检查 调试工具 与所选 PHP 解释器相关的安装：

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

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

      • 所选 PHP 安装的版本。

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

        

   或者，打开 安装向导 ，粘贴输出 phpinfo() ，然后点击 分析我的 phpinfo() 输出 . 详细了解如何检查 调试工具 安装在 验证调试引擎的配置 。

定义 Xdebug 行为

1. 在 IDE 设置中（ Ctrl+Alt+S ）， 选择 调试 根据 PHP 节点打开 调试 页。

2. 在里面 调试工具 区域中，指定以下设置：

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

     这必须与 php.ini 文件：

     xdebug.client_port=""

     xdebug.remote_port=""

     默认情况下，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 解释器 在打开的对话框中，单击 在编辑器中打开 旁边的链接 配置文件： 文件。关闭所有对话框，然后切换到 php.ini 文件已打开。

   3. 在里面 php.ini 文件，找到 [xdebug] 部分，并在其中添加以下行进行注释 ; 介词：

      ;[xdebug] ;zend_extension = ""

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

      

2. 为了让 PhpStorm 在必要时激活 Xdebug，请在 调试器扩展 领域，在 额外的 区域。手动输入路径或点击 并在打开的对话框中选择位置。