怎样解决 PHP 环境下内存泄漏导致的进程崩溃_使用 valgrind 进行排查-php教程-PHP中文网

valgrind 不能直接查 php 脚本层内存泄漏，仅对 php 解释器、c 扩展或 zend 引擎底层有效；需配合单 worker 模式、压制文件及栈追踪定位真实泄漏点。

怎样解决 php 环境下内存泄漏导致的进程崩溃_使用 valgrind 进行排查

valgrind 能查 PHP 内存泄漏吗？只在特定场景下有效

不能直接查 PHP 脚本层的内存泄漏，但能查 PHP 解释器本身、C 扩展或 Zend 引擎底层的内存问题。如果你的 php-fpm 进程在处理请求后 RSS 持续上涨、segfault 频发，或 Valgrind 报出 Invalid read/write、definitely lost，那大概率是 C 层出了问题——比如自定义扩展没调 efree()、zval 引用计数操作错误、或 malloc 后忘记 free。

它对纯 PHP 的循环引用、static 变量堆积、闭包捕获等完全无效——这些得靠 memory_get_usage() + gc_collect_cycles() 或 Xdebug 堆快照。

用 valgrind 跑 php-fpm 时必须绕开的三个坑

直接 valgrind --tool=memcheck php-fpm 会失败，常见原因：

php-fpm 启动后 fork 多进程，valgrind 默认只跟踪主进程，子进程的内存行为全丢
PHP 的 ZendMM 内存池（chunk/page/slot）大量使用 mmap 和自定义分配器，valgrind 默认不识别，误报极多
系统级信号（如 SIGCHLD、SIGUSR2）和 fpm manager 的进程控制逻辑会让 valgrind 崩溃或卡死

正确做法是：用 -x 参数让 fpm 进入单 worker 模式，并禁用 daemonize：

valgrind --tool=memcheck \
  --leak-check=full \
  --show-leak-kinds=all \
  --track-origins=yes \
  --suppressions=/usr/lib/valgrind/php.supp \
  /usr/sbin/php-fpm8.6 -F -R -y /etc/php/8.6/fpm/php-fpm.conf

其中 /usr/lib/valgrind/php.supp 是必须的压制文件（来自 PHP 源码 scripts/dev/generate-valgrind-suppressions.php），否则满屏 false positive。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

怎么确认 valgrind 报的 leak 真和你的扩展有关

valgrind 输出里关键看两行：

definitely lost: X bytes in Y blocks —— 真泄漏，地址没被任何指针持有
still reachable: Z bytes in W blocks —— 多数是全局变量或未释放的静态缓存，不一定危险

重点检查 stack trace 中是否出现你的扩展函数名，例如：

==12345==    at 0x...: myext_process_data (myext.c:247)
==12345==    by 0x...: zif_myext_handle (myext.c:102)

如果 stack trace 停在 zend_hash_add、emalloc、add_next_index_string 等 Zend API，说明你在扩展里用了它们但没配对调 efree 或 zval_ptr_dtor；如果停在 curl_easy_init 或 PQconnectdb，就要检查是否漏了 curl_easy_cleanup 或 PQfinish。

比 valgrind 更快定位 PHP 扩展泄漏的替代方案

valgrind 太慢（常拖慢 20–50 倍），且不能覆盖所有运行时路径。日常排查优先用这些：

启用 ZEND_MM_HEAP_DUMP 环境变量：ZEND_MM_HEAP_DUMP=1 php your_script.php，输出 raw 内存块分配栈（需 PHP 编译时带 --enable-debug）
用 meminfo 扩展生成堆快照：meminfo_dump('/tmp/heap.json')，再用 meminfo-analyze 查对象引用链
检查扩展的 PHP_MSHUTDOWN_FUNCTION 是否清空了所有全局 void* 缓存，以及 PHP_RSHUTDOWN_FUNCTION 是否释放了 per-request 资源