配置 Xdebug

下载 Xdebug

• 下载与您的 PHP 版本兼容的Xdebug 扩展，并按照安装指南中的说明进行安装。

  如果您使用的是AMP 包，则可能已经安装了 Xdebug 扩展。请参阅特定于您的包裹的说明。

将 Xdebug 与 PHP 解释器集成

1. 在编辑器中打开活动的php.ini文件：

   1. 在“设置/首选项”对话框 ( Ctrl+Alt+S) 中，单击PHP。

   2. 在打开的PHP页面上，单击CLI Interpreter字段旁边的。

   3. 在打开的CLI 解释器对话框中，配置文件只读字段显示活动php.ini文件的路径。单击在编辑器中打开。

2. 要禁用阻止 Xdebug 的Zend Debugger和Zend Optimizer工具，请删除或注释掉php.ini文件中的以下行：

   zend_extension=<path_to_zend_debugger> zend_extension=<path_to_zend_optimizer>

3. 要启用 Xdebug，请在php.ini[xdebug]文件中找到或创建该部分并按如下方式更新它：

   [xdebug] zend_extension="<xdebug 扩展的路径>" xdebug.mode=debug xdebug.client_host=127.0.0.1 xdebug.client_port="<Xdebug 连接的端口（默认为9003）>"

   [xdebug] zend_extension="<xdebug 扩展的路径>" xdebug.remote_enable=1 xdebug.remote_host=127.0.0.1 xdebug.remote_port="<Xdebug 连接的端口（默认为9000）>"

   要通过 Xdebug proxies 启用多用户调试，请找到xdebug.idekey设置并为其指定一个您选择的值。此值将用于在 Xdebug 代理服务器上注册您的 IDE。

4. 保存并关闭php.ini文件。

5. 通过执行以下任一操作来验证 Xdebug 安装：

   • 在命令行中，运行以下命令：

     php --版本

     输出应该在已安装的扩展中列出Xdebug ：

     

   • 创建一个包含以下代码的php文件：

     <?php phpinfo();

     在浏览器中打开文件。phpinfo输出应包含 Xdebug 部分：

     

在 PhpStorm 中配置 Xdebug

1. 按Ctrl+Alt+S打开 IDE 设置并选择PHP。

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

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

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

      • 所选 PHP 安装的版本。

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

        

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

3. 定义 Xdebug 行为。单击PHP节点下的调试。在打开的调试页面上，在Xdebug区域中指定以下设置：

   • 在Debug port字段中，指定工具将通过其与 PhpStorm 通信的端口。

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

     xdebug.client_port="<Xdebug 连接的端口（默认为 9003）>"

     xdebug.remote_port="<Xdebug 连接的端口（默认为 9000）>"

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

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

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

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

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

4. 在“外部连接”区域中，指定您希望 PhpStorm 如何处理从主机接收的连接以及通过未注册为部署服务器配置的端口接收的连接。

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

   • Break at first line in PHP scripts : 选中此复选框可在调试器与 PhpStorm 之间的连接建立后立即停止（而不是在到达第一个断点之前自动运行）。或者打开运行 | 在主菜单中的 PHP 脚本选项中的第一行中断。

   • 最大限度。同时连接使用此旋转框来限制可以同时处理的外部连接的数量。