使用 Xdebug 进行分析

配置 Xdebug

1. 下载并安装Xdebug 工具。

2. 将 Xdebug 与 PHP 引擎集成。

3. 将 Xdebug 与 PhpStorm 集成。

启用 Xdebug 分析器

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

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

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

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

2. 执行以下操作之一：

   • 要永久启用分析器，请设置xdebug.profiler_enable（对于 Xdebug 2）或xdebug.mode（对于 Xdebug 3）指令：

     xdebug.mode = 配置文件；

     xdebug.profiler_enable = 1;

   • 要启用使用 cookie 或 GET/POST 参数从浏览器触发分析器，请XDEBUG_PROFILE根据使用的 Xdebug 版本设置以下指令：

     xdebug.mode = 配置文件；xdebug.start_with_request = 触发器；

     xdebug.profiler_enable = 0; xdebug.profiler_enable_trigger = 1;

配置从浏览器切换探查器的方式

要指定XDEBUG_PROFILE cookie 或 GET/POST 参数，请执行以下操作之一：

• 手动指定值。

• 生成小书签以切换调试器。这些小书签将出现在浏览器的工具栏上。它们提供对调试器 cookie 的控制，通过它们您将激活和停用调试器。

  1. 根据浏览器类型执行以下操作之一，在浏览器中启用书签工具栏：

     • 在Firefox中，选择查看 | 工具栏 | 书签工具栏。

     • 在Chrome中，选择书签 | 显示书签栏。

  2. 在设置/首选项对话框 ( Ctrl+Alt+S) 中，导航到PHP | 调试。

  3. 在打开的调试页面上，单击使用调试器小书签从您喜欢的浏览器链接启动调试器。

  4. 在打开的Zend Debugger & Xdebug 书签页面上，检查调试引擎设置并单击Generate。生成列出的与调试相关的操作的书签。

  5. 将生成的链接拖到浏览器中的书签工具栏。

指定存储累积分析数据的位置

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

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

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

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

2. 通过指定xdebug.profiler_output_dir（对于 Xdebug 2）或xdebug.output_dir（对于 Xdebug 3）指令来定义累积分析快照的位置。

   xdebug.output_dir = "<输出文件夹路径>"

   xdebug.profiler_output_dir = "<输出文件夹路径>"

3. 通过指令的值指定要存储快照的文件的名称xdebug.profiler_output_name。默认名称是cachegrind.out.%p，其中%p是名称格式说明符。接受默认名称或定义符合以下标准的自定义名称：

   1. 该名称应始终为cachegrind.out。

   2. 使用支持的格式说明符。

启动 Xdebug 调试会话

执行以下操作之一：

• 要开始调试整个应用程序，请创建类型为PHP Web Page的调试配置，然后单击 启动调试。

  有关详细信息，请参阅使用 PHP 网页调试配置进行调试。

• 要调试特定的 PHP HTTP 请求，请定义类型为PHP HTTP Request的调试配置，然后单击 启动调试。

  有关详细信息，请参阅调试 PHP HTTP 请求。

• 要启动零配置调试会话：

  1. 切换 PhpStorm 工具栏上的Start Listen PHP Debug Connections按钮，使其变为. 之后，PhpStorm 开始监听当前项目中使用的调试引擎的端口。调试端口设置在PHP |上的 PhpStorm 级别。设置/首选项对话框 ( Ctrl+Alt+S)的调试页面。

  2. 在浏览器中打开应用程序的起始页，选择Start debugger书签以从浏览器中激活调试引擎，重新加载当前页面（应用程序的起始页），然后返回 PhpStorm。

检索分析器累积的数据

1. 从主菜单中，选择工具 | 分析 Xdebug Profiler 快照。

2. 在打开的Select Xdebug profiler snapshot对话框中，选择存储分析数据的文件夹和文件。

   PhpStorm 在单独的编辑器选项卡中显示收集的分析数据，并带有所选分析器输出文件的名称。

检查分析数据

当您请求累积的分析数据时，PhpStorm 在单独的编辑器选项卡中打开其可视化演示。该选项卡以选定的探查器输出文件命名，由多个视图组成。在视图之间切换以根据各种分析标准分析分析数据。

• 在Execution Statistics视图中，检查有关每个调用函数的执行指标的摘要信息。

• 在调用树视图中，探索所有被调用函数的执行路径。

• 要探索特定函数的执行路径，请在“调用树”视图中选择该函数并在“被调用者”视图中查看其被调用者。

• 要探索可能导致调用特定函数的所有路径，请在“调用树”视图中选择该函数并在“调用者”视图中检查其可能的调用者。