PHPStorm配置Xdebug官方文档

时间:2023-09-11 13:04:56

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字段PHPStorm配置Xdebug官方文档旁边的。

    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:

      PHPStorm配置Xdebug官方文档

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

      phpinfo();

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

      PHPStorm配置Xdebug官方文档

在PHP 5.3及更高版本,您只需要使用zend_extension,而不是zend_extension_tszend_extension_debugextension

在PhpStorm中配置Xdebug

  1. 在“ 设置/首选项”对话框(Ctrl+Alt+S)中,选择“ 语言和框架”| PHP。

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

    1. 在PHP页面上,从CLI解释器列表中选择相关的PHP安装,然后单击该字段旁边的“ 浏览 PHPStorm配置Xdebug官方文档 ”。该列表显示了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