Xdebug文档(六) 分析PHP脚本

小磊吖_4194

小磊吖_4194

2016-06-20

1261人浏览

原创

分析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”)。圆括号中的数字代表平均值。下方面板也是类似显示,但不同的是它显示当前选择的函数调用的所有函数信息,不管是直接还是间接的。

相关设置

 

xdebug.profiler_append

类型: integer, 默认值: 0

设为1时,分析文件工作在新的请求下映射到相同的文件时(取决于xdebug.profiler_output_name)不会下覆盖分析结果,而是分析信息附加到尾部形成新的分析文件。

 

xdebug.profiler_enable

类型: integer, 默认值: 0

开启Xdebug的分析器能在profile output directory目录中创建分析文件。这些文件能被KcacheGrind读取而可视化分析数据。该设置不能使用ini_set()在脚本中设置。如果你要选择性开启分析器,可以使用 xdebug.profiler_enable_trigger设置设为1代替使用。

 

xdebug.profiler_enable_trigger

类型: integer, 默认值: 0

设为1时,你就能使用XDEBUG_PROFILE的GET/POST参数或设置XDEBUG_RPOFILE的cookie值触发分析文件的产生。这些写入分析数到预定义的目录中,为了不上分析文件在每次请求中产生,你需要设置xdebug.profiler_enable 为0值。访问触发器可能过xdebug.profiler_enable_trigger_value配置。

 

xdebug.profiler_enable_trigger_value

类型: string, 默认值: "", 始于 Xdebug > 2.3

如xdebug.profiler_enable_trigger所述,该设置用于限制谁能利用XDEBUG_PROFILE功能。当改变原本的空字符串默认值后,cookie,GET或POST参数值需要匹配共享秘密集合并随设置开启分析器。

 

xdebug.profiler_output_dir

类型: string, 默认值: /tmp

该目录为分析文件输出的地方,请确保运行PHP的账户能对该目录有写入权限。该设置不能用ini_set()在脚本中设置。

 

xdebug.profiler_output_name

类型: string, 默认值: cachegrind.out.%p

该设置决定分析文件的名称,可使用格式标识符指定,类似于sprintf() 和strftime()。有几种标识符可格式化文件名。详见参考xdebug.trace_output_name说明。

 

相关函数

 

string xdebug_get_profiler_filename()

返回当前保存的分析信息的文件名称。

 

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

120

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

60

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

140

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

120

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

100

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

100

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

100

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习