Ubuntu下解决 ThinkPHP 内存溢出的实用步骤
一 快速缓解与定位
- 先确认 PHP 内存上限：在 Web 环境内临时输出或查看 phpinfo，确认当前生效的 memory_limit（如 128M）。
- 临时放宽上限（仅用于排查）：在入口或公共引导位置加入
ini_set(‘memory_limit’, ‘256M’);
若 CLI 任务（如数据导入/定时任务）报错，同样在 CLI 入口设置。
- 若放宽后仍然很快耗尽，通常不是配置不足，而是代码或数据导致的内存暴涨，需要按下一节定位。
二 正确调整 Ubuntu 上的 PHP 内存上限
- 修改 CLI 配置（命令行脚本、定时任务）：
sudo nano /etc/php/7.x/cli/php.ini
将 memory_limit 调整为合适值（如 256M 或更高）。
- 修改 FPM 配置（Nginx/Apache+PHP-FPM 场景）：
sudo nano /etc/php/7.x/fpm/php.ini
设置 memory_limit，然后重启 PHP-FPM：sudo systemctl restart php7.x-fpm。
- 修改 Apache 模块方式：
sudo nano /etc/apache2/conf-available/php7.x.conf
加入或调整：php_value memory_limit 256M；重启 Apache：sudo systemctl restart apache2。
- 修改 Nginx + PHP-FPM 方式：
在 Nginx 站点配置 server 块中加入：
fastcgi_param PHP_VALUE “memory_limit=256M”;
然后重启 Nginx：sudo systemctl restart nginx。
- 注意：CLI 与 FPM/Apache 的 php.ini 是分开的，修改后需重启对应服务；不要设置为 -1（不限制）于生产环境。
三 ThinkPHP 常见诱因与修复
- 模板引擎死循环：错误指向 ThinkTemplate.class.php 且伴随 include/if/empty 等标签时，往往是模板标签逻辑或循环引用导致。做法是二分注释模板标签定位问题标签，必要时将问题标签替换为原生 PHP（如 include 或 if 判断），从根因上解除无限递归或重复包含。
- 大数据量一次性加载：统计/导出/批处理等场景把整表或超大结果集一次性读入内存，极易触发上限。应改为分页/游标/生成器逐批处理，只查必要字段，处理完及时 unset 大变量，降低峰值占用。
- 低效查询与缓存不足：慢查询放大内存与执行时间，结合索引优化、查询条件裁剪，并将热点数据放入 Redis/Memcached，减少重复计算与数据库压力。
四 运行环境与进程配置优化
- 启用并正确配置 OPcache（生产环境强烈建议）：减少重复编译开销，降低 CPU 与内存抖动。
- 合理设置 PHP-FPM 进程池参数（如 pm.max_children、pm.start_servers、pm.min_spare_servers、pm.max_spare_servers），避免进程过多导致物理内存被吃满，或过少造成排队。
- 监控与排查：在关键位置使用 memory_get_usage() 打点，配合 Xdebug/Blackfire 做内存与性能分析，定位内存峰值与泄漏点。
五 最小改动的一键式排查清单
- 入口处临时设置：ini_set(‘memory_limit’, ‘256M’); 观察是否仍 OOM。
- CLI 与 FPM 分别检查并统一 memory_limit；CLI 跑脚本复现问题，FPM 复现线上场景。
- 二分注释/替换模板标签，优先排查 include 循环与复杂条件嵌套。
- 将大数据处理改为分页/游标/生成器；只 select 必要字段；处理完 unset 大数组/对象。
- 打开慢查询日志与 OPcache；用 Xdebug/Blackfire 采样定位热点函数与内存峰值。
- 调整 PHP-FPM 进程数与静态资源缓存策略，避免并发放大内存压力。