PHP中无官方memprof扩展，实际用于内存泄漏定位的是Xdebug的memory profiling功能，需启用xdebug.mode=develop,memory，用xdebug_start/stop_memory_profile()生成快照，再通过memprof_analyser.php解析定位高耗函数。
PHP 中没有官方叫 memprof 的独立扩展，它常被误用为对 Xdebug 内存分析功能的简称（如 .memprof_*.out 文件），或与 Ruby 的 memprof gem 混淆。真正用于 PHP 生产环境内存泄漏定位的核心工具是 Xdebug 的 memory profiling 功能，配合其解析脚本 memprof_analyser.php 使用。下面直接讲清楚怎么装、怎么用、怎么在线上安全抓快照。
确认并启用 Xdebug 内存分析模式
不是所有 Xdebug 安装都默认支持内存分析。必须显式开启 memory 模式：
- 检查当前配置：运行
php -i | grep "xdebug.mode"，输出中需含memory - 编辑
php.ini，添加或修改两行：xdebug.mode = develop,memoryxdebug.output_dir = "/tmp/xdebug"（确保该目录存在且 PHP 进程可写） - 重启 PHP-FPM 或 Apache；验证命令
php -v不报错，且php --ri xdebug显示 mode 包含 memory
零侵入生成线上内存快照（.out 文件）
无需改主逻辑，用信号或条件触发即可，适合灰度或问题复现阶段：
- 在脚本开头加：
xdebug_start_memory_profile(); - 在关键路径末尾（如请求结束前、循环后、或异常捕获的
finally块）加：xdebug_stop_memory_profile(); - 若服务是长周期运行（如 CLI 守护进程），可用
pcntl_signal(SIGUSR1, function() { xdebug_stop_memory_profile(); });实现按需停止 - 运行后检查
/tmp/xdebug/是否生成类似memprof_1745123456.out的文件——这就是内存分配快照
解析快照定位泄漏源头
原始 .out 文件是纯文本，需用官方解析器排序聚焦高耗函数：
立即学习“PHP免费学习笔记（深入）”；
- 下载
memprof_analyser.php（来自 Xdebug GitHub tools 目录） - 执行解析命令（禁用 Xdebug 避免干扰）：
php -dxdebug.mode=off /path/to/memprof_analyser.php /tmp/xdebug/memprof_1745123456.out - 结果按 Total memory allocated 降序排列，重点关注顶部几行的 Function 列
- 顺着 Called from 向上追溯调用链，最终落到你自己的类方法、闭包或框架钩子中
进阶：比对堆快照确认对象滞留（.zsnap）
如果 .out 文件只显示“分配多”，但不确定是否泄漏（即对象没被回收），需进一步生成堆快照比对实例数：
- 在疑似泄漏前后调用：
$snap1 = xdebug_create_memory_snapshot("/tmp/snap1.zsnap");// 执行可疑逻辑（如缓存填充、事件监听注册）$snap2 = xdebug_create_memory_snapshot("/tmp/snap2.zsnap"); - 使用
xdebug_get_memory_snapshot_diff($snap1, $snap2)获取差异数组，重点看class_name和instances变化量大的类 - 结合
gc_collect_cycles()主动触发回收，再对比——若实例数不降，基本可判定是循环引用或全局引用导致的泄漏
