使用 Xdebug 进行性能分析

设置 Xdebug

1. 下载并安装 Xdebug 工具。

2. 将 Xdebug 集成到 PHP 引擎中。

3. 将 Xdebug 集成到 PhpStorm 中。

在 php.ini 中配置 Xdebug 性能分析器

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

   1. 在 设置 对话框（Ctrl+Alt+S ）中，单击 PHP。

   2. 在打开的 PHP 页面上，单击 ，位于 CLI 解释器 字段旁边。

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

2. 通过以下方式之一启用 Xdebug 性能分析器模式：

   • 要永久启用性能分析器，请将 xdebug.mode （适用于 Xdebug 3）或 xdebug.profiler_enable （适用于 Xdebug 2）设置为 profile：

     xdebug.mode = profile

     xdebug.profiler_enable = 1

   • 要通过使用 XDEBUG_PROFILE Cookie 或 GET/POST 参数从浏览器触发性能分析器，请根据所使用的 Xdebug 版本设置以下设置：

     xdebug.mode = profile xdebug.start_with_request = trigger

     xdebug.profiler_enable = 0 xdebug.profiler_enable_trigger = 1

3. 指定存储性能分析快照的位置：

   1. 添加 xdebug.output_dir （Xdebug 3）或 xdebug.profiler_output_dir （Xdebug 2）设置，并将目录路径指定为其值。

      xdebug.output_dir = <path to output folder>

      xdebug.profiler_output_dir = <path to output folder>

   2. 添加 xdebug.profiler_output_name设置，并将存储快照的文件名指定为其值。

      默认值为 cachegrind.out.%p ，其中 %p 是名称格式说明符。 使用默认值或根据 支持的格式说明符定义自定义文件格式。 请注意，名称应始终为 cachegrind.out 。

      xdebug.profiler_output_name = cachegrind.out.%p

配置从浏览器切换性能分析器

要从浏览器启用性能分析器，请执行以下任一操作：

• 使用 XDEBUG_PROFILE Cookie 变量或 ?XDEBUG_PROFILE=1 URL 参数，如 Xdebug 文档中所述。

• 使用 Xdebug Helper 浏览器扩展（例如，适用于 Chrome 的 JetBrains 的 Xdebug Helper）。

  

请执行以下操作之一：

• 要开始调试整个应用程序，请创建类型为 PHP 网页 的调试配置，并通过单击 启动调试。

  有关更多信息，请参见 使用 PHP 网页调试配置进行调试。

• 要调试特定的 PHP HTTP 请求，请定义类型为 PHP HTTP 请求 的调试配置，并通过单击 启动调试。

  有关更多信息，请参见 调试 PHP HTTP 请求。

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

  1. 切换 PhpStorm 工具栏或状态栏上的 开始监听 PHP 调试连接 按钮 ，使其更改为 。 之后，PhpStorm 开始监听当前项目中使用的调试引擎的端口。 调试端口在 PhpStorm 的 PHP | Debug 页面上的 设置 对话框（Ctrl+Alt+S ）中设置。

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

检索由性能分析器累积的数据

1. 在主菜单中，进入 工具 | 分析Xdebug 分析器快照….

2. 在打开的 选择 Xdebug 分析器快照 对话框中，选择存储性能分析数据的 文件夹和文件。

   PhpStorm 在单独的编辑器选项卡中以所选性能分析器输出文件的名称呈现收集的性能分析数据。

   

   您可以一次选择并打开多个快照。 在这种情况下，PhpStorm 会汇总所有选定快照的性能分析数据，并在单个选项卡中显示平均结果。

检查性能分析数据

在选项卡之间切换以分析性能分析数据。 要快速在选项卡中找到特定函数，请使用 快速搜索。

• 执行统计 ：使用此选项卡检查每个被调用函数的 执行指标的摘要信息。

• 调用树 ：使用此选项卡探索所有被调用函数的执行路径。

• 被调用方 ：使用此选项卡探索在 调用树 选项卡中选择的特定函数的执行路径。

• 调用方 ：使用此选项卡探索可能导致调用 调用树 选项卡中选择的特定函数的所有路径。