使用Xdebug生成函数调用图与性能报告的工具推荐-php教程-PHP中文网

必须安装 graphviz 的 dot 工具才能生成函数调用图；cachegrind.out.* 文件本身无图形，qcachegrind 和 kcachegrind 均依赖 dot 渲染调用图，缺失时显示“call graph: disabled (dot not found)”。

使用xdebug生成函数调用图与性能报告的工具推荐

用 `cachegrind.out.*` 文件生成函数调用图必须配 `dot`

Xdebug 生成的性能报告（如 cachegrind.out.12345）本身是纯文本格式，不带图形；要看到「函数调用图」（Call Graph），必须依赖 dot 工具——它是 Graphviz 的核心命令行程序。没装 dot，所有图形界面工具（WebGrind、QCachegrind）的调用图按钮都会灰掉或报错。

常见错误现象：Call Graph: disabled (dot not found) 或 WebGrind 页面显示 “Graph generation failed”。

macOS 上通过 brew install graphviz 后，dot 默认在 /usr/local/bin/dot，但部分工具（如旧版 WebGrind）硬编码查找 /usr/bin/dot
解决方法不是改系统 PATH，而是：要么建软链 sudo ln -s /usr/local/bin/dot /usr/bin/dot，要么直接改工具配置（如 WebGrind 的 config.php 中修改 $dotExecutable）
Linux 用户注意：Debian/Ubuntu 需额外装 graphviz 包，仅装 kcachegrind 不够

QCachegrind 和 KCacheGrind 哪个更稳？

两者底层都是 Qt + Cachegrind 解析器，功能几乎一致，区别主要在平台适配和默认行为：

QCachegrind 是跨平台版本（macOS/Linux/Windows），启动快，对大文件（>100MB）内存占用略低，推荐 macOS 用户首选
KCacheGrind 是 KDE 原生应用，Linux 桌面集成更好，但某些发行版仓库里版本老旧（如 Ubuntu 22.04 自带 0.7.4），不支持 Xdebug 3.3+ 新增的 `xdebug.mode=profile` 生成的头部字段，可能解析失败
都支持火焰图切换（View → Flame Graph）、调用树折叠、热点函数筛选（Hot Spot）、双击跳转源码（需路径映射正确）

验证是否可用：终端执行 qcachegrind /tmp/xdebug/cachegrind.out.*，若能加载并显示顶部「Flat Profile」表格，说明基础链路通了。

WebGrind 适合快速查线上 profile，但别信它的“实时刷新”

WebGrind 是 PHP 写的 Web 界面，部署简单（丢进 Web 目录即可），适合没有桌面环境的服务器或临时分享分析结果。但它有三个硬伤：

Xdebug 3.4.1

Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有

下载

不支持增量分析：每次点「Update」都会重新解析整个 cachegrind.out.* 文件，10MB 文件可能卡住 3–5 秒，浏览器无响应提示
「Call Graph」依赖外部 dot 渲染为 PNG，生成的图片不会缓存，反复点击会重复调用 dot，CPU 瞬间拉满
无法处理 Xdebug 3.3+ 默认启用的压缩输出（xdebug.profiler_output_name=cachegrind.out.%t-%s 中含毫秒时间戳），需手动确保文件名匹配其扫描逻辑（默认只认 cachegrind.out.*）

建议只把它当「初筛工具」：打开后先看「Function Summary」表格，找耗时 Top 5 函数；确认瓶颈后再用 QCachegrind 打开同一文件做深度下钻。

`xdebug.mode=profile` 配置下生成的文件，为什么有些工具打不开？

Xdebug 3.x 彻底重构了配置模型，xdebug.profiler_enable 这类旧参数已废弃。如果仍用老教程配置（比如只设 xdebug.profiler_enable_trigger=1 但没设 xdebug.mode），Xdebug 会静默忽略 profiler 请求，不报错也不生成文件。

正确姿势必须包含两步：

全局启用模式：xdebug.mode=profile（或 xdebug.mode=develop,profile）
按需触发：xdebug.start_with_request=no + xdebug.trigger_value=perf（然后请求带 XDEBUG_TRIGGER=perf）

生成的文件头部会带 cmd: php 和 part: 1 字段。老版本 KCachegrind（part 字段而拒绝加载——这不是文件损坏，是解析器版本太低。此时降级用 xdebug.mode=profile + xdebug.output_name=cachegrind.out.%t 强制生成传统命名格式，或直接升级分析工具。

真正容易被忽略的是：Xdebug 3.x 默认把 profile 文件写到 /tmp，但某些容器或加固系统会挂载 /tmp 为 noexec，导致写入失败且无日志提示。检查 xdebug.log 里有没有 Could not open profiler file 才能定位。