PHPStorm配置Xdebug官方文档

1 配置Xdebug

下载Xdebug

• 下载与您的PHP版本兼容的Xdebug扩展，并将其保存在该php/文件夹中。

  • php/文件夹 的位置是在安装PHP引擎期间定义的。

  • 如果您使用的是AMP软件包，则可能已安装Xdebug扩展。按照xdebug.txt中的说明进行操作。

将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="<path to php_xdebug.dll>" xdebug.remote_enable=1 xdebug.remote_port="<the port for Xdebug to listen to>" (the default port is 9000)

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

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

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

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

     php --version

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

     

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

     phpinfo();

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

     

在PHP 5.3及更高版本，您只需要使用zend_extension，而不是zend_extension_ts，zend_extension_debug或extension

在PhpStorm中配置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会显示Debugger: Not installed。

   或者，打开Xdebug检查器，粘贴输出phpinfo()，然后单击Analyze my phpinfo（）输出。了解有关在验证调试引擎配置中检查Xdebug安装的详细信息。

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

   • 在“ 调试端口”文本框中，指定工具与PhpStorm通信的端口。这必须与php.ini文件中指定的端口号完全相同：

     xdebug.remote_port = <port_number>
     默认情况下，Xdebug侦听端口9000。 

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

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

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

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

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

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

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

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

2 参考

使用谷歌翻译于 https://www.jetbrains.com/help/phpstorm/configuring-xdebug.html