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