memory_get_peak_usage 返回脚本启动至当前时刻的最大内存使用量（字节），类型为 int，是历史峰值而非实时占用，且仅统计 PHP 自身分配的内存。
memory_get_peak_usage 返回什么值？
它返回脚本从启动到当前时刻所使用的最大内存量（字节），类型是 int。注意：这个值不是实时内存占用，而是历史峰值，且只统计 PHP 自己分配的内存（不包含外部扩展如 cURL 缓冲区、OPcache 元数据等）。
常见误用是把它当成“当前内存占用”，结果发现数值一直不下降——因为它是峰值，只会增不会减。
调用时机和参数影响
memory_get_peak_usage() 接受一个可选布尔参数：$real_usage。默认为 false，此时返回的是 PHP 内存管理器估算的用量（通常更小）；设为 true 时，返回底层 malloc 实际申请的内存（含对齐开销，数值更大，更接近系统级观测值）。
- 调试内存泄漏或对比扩展行为时，建议统一用
memory_get_peak_usage(true) - 监控线上服务时，用
false（默认）更稳定，避免因内存对齐差异造成抖动 - 两次调用之间若触发了垃圾回收（如显式
gc_collect_cycles()），峰值可能不变，但后续增长会基于新基线
实际测量中容易踩的坑
直接在脚本末尾调用 memory_get_peak_usage() 得到的值，往往比预期高——因为 PHP 在脚本结束前会做清理（如析构对象、释放临时变量），但这些动作本身也消耗内存，且峰值已计入。
立即学习“PHP免费学习笔记（深入）”；
- 想测某段逻辑的峰值，得在该逻辑前后分别调用，再取差值：
$before = memory_get_peak_usage(); /* your code */ $after = memory_get_peak_usage(); $delta = $after - $before; - CLI 模式下，
echo或var_dump输出大数组会显著推高峰值（输出缓冲区也算内存） - Web SAPI（如 Apache mod_php）中，每次请求共享进程内存池，
memory_get_peak_usage()只反映单次请求生命周期，不能跨请求累加
与 memory_limit 配合判断是否濒临溢出
单纯看峰值数字意义有限，需结合 ini_get('memory_limit') 做比例判断。注意 memory_limit 可能是字符串（如 "128M"），需手动解析：
$limit = ini_get('memory_limit');
$limit_bytes = is_numeric($limit) ? (int)$limit : (int)trim($limit, 'MGKB') * 1024 ** (strpos($limit, 'G') ? 3 : (strpos($limit, 'M') ? 2 : (strpos($limit, 'K') ? 1 : 0)));
$peak = memory_get_peak_usage();
if ($peak > $limit_bytes * 0.9) {
error_log("Memory peak usage: " . round($peak / 1024 / 1024, 1) . "MB / " . $limit);
}
这种检查必须放在脚本靠后位置（确保大部分内存已分配），但别等到 __destruct 阶段——那时部分资源已被释放，峰值可能已回落。
