Xdebug文档（六）分析PHP脚本

分析PHP脚本Xdebug内置分析器能让你找到脚本中的瓶颈并用额外的工具诸如KcacheGrind或WinCacheGrind工具可视化。

介绍

Xdebug分析器是分析PHP代码和判断瓶颈或确定代码哪里运行过慢需要使用加速器的强大分析器。Xdebug2的分析器输出信息以cachegrind兼容文件形成表现。这能让你使用优秀的KcacheGrind工具（Linux,KDE）来分析数据。如果你用Linux你可以在你安装管理器安装它。

Windows下也有预编译的QcacheGrind二进制安装包可用（QCacheGrind 是KcacheGrind不捆绑KDE的版本）

如果你用Mac系统，这里有介绍如何安装QcacheGrind。

Windows用户也可以选择使用WinCacheGrind。但其功能与KcacheGrind不一样所以本文不在此介绍该软件。Xdebug2.3出版时，WinCacheGrind当前仍不支持cachegrind压缩功能和文件。

如果你不使用KDE(或不想用)，kcachegrind包也携带perl脚本“ct_annotate”能分析跟踪文件输出ASCII。

开始分析

Php.ini内设置xdebug.profiler_enable设为1开启分析。该设置命令xdebug启用分析并写入到 xdebug.profiler_output_dir指定的目录中。而产生的文件名一般以”cachegrind.out”开头，然后结尾跟着以PHP（或apache）进程PID（进程ID）或包含初始调试脚本目录的crc32哈希值。确保你的xdebug.profiler_output_dir设置目录有足够的空间保存分析对复杂脚本分析生成庞大的分析数据。比如有500MB以上的复杂应用程序 eZ Publish。

你也可以通过 xdebug.profiler_enable_trigger 设为1手动开启分析器。当它设为1后，你能让分析器使用名为XDEBUG_PROFILE的变量利用到GET/POST 或者 COOKIE 值。 FireFox 2 扩展能用于开启debugger (参考 HTTP Debug Sessions) 也能用于使用该设置。为了触发器能合理地运行， xdebug.profiler_enable 需要设为0。

分析输出

当产生分析结果后，你就能利用 KCacheGrind打开它：

一旦打开了文件，KCacheGrind会有不同的面板提供充足的信息让你参考。左侧你能看到"Flat Profile"面板列出所有脚本函数并以花费时间为序，还包括了它的子函数时间。第二列"Self"显示该函数（不包括子函数）花费的时间，第三列"Called"指被调用的频度，最后一列”functions”显示函数名称。Xdebug改变PHP内部函数名并在函数名加前缀“php::”，而引用文件也在用指定的方式处理。呼叫include命令都跟随“::”和引用的文件名. 左侧截图你能看到"include::/home/httpd/ez_34/v..." 和内存函数示例"php::mysql_query"。头两列的数量能以百分数表示总运行时间的占比（看示例）或绝对时间（1单元代表1/1.000.000之一秒）。你可以用右边的按钮来切换这两种模式。

右边的面板包含上层和下层两面板。上层面板显示哪个函数调用了当前选择的函数（截图中"eztemplatedesignresource->executecompiledtemplate). 下层面板显示已选择的函数调用的函数列表。

上层面板的Cost列显示当前选择的函数在列表内被调用时花费的时间。该数字在Cost列通常是100%。下方面板Cost列显示在列表中调用的函数所花费的时间。在这列的数字当中，你绝不看到达100%执行时间的函数。

"All Callers" 和 "All Calls"显示不仅仅是函数分别执行的直接调用而且还显示函数更多的上下级关系。截图中的上层面板显示当前选择的函数调用的所有函数列，直接和间接关系的其他函数都在堆栈中间。（翻译能力有限……原句是这样的：The upper pane in the screenshot on the left shows all functions calling the current selected one, both directly and indirectly with other functions inbetween them on the stack.）“Distance”列代表有多少函数呼叫在列表当中，而当前选择的为（-1）。如果两函数间有不同的距离，此外会显示一范围值（例如：“5-24”）。圆括号中的数字代表平均值。下方面板也是类似显示，但不同的是它显示当前选择的函数调用的所有函数信息，不管是直接还是间接的。