Ubuntu系统下PHP内存限制超出的解决方法

在Ubuntu系统中运行PHP程序时，经常会遇到“Allowed memory size of X bytes exhausted”这类内存限制超出的报错，通常是因为PHP默认的内存配置无法满足当前程序的运行需求。本文会介绍几种常见的排查和解决方式，帮你快速处理这类问题。

一、快速定位问题：查看当前PHP内存配置

首先要确认当前PHP的内存限制配置，避免盲目修改。可以在项目目录下创建一个临时的PHP文件，用来输出当前的内存限制参数。

<?php
// 输出当前PHP脚本的内存限制配置
echo "当前内存限制: " . ini_get('memory_limit') . PHP_EOL;
// 输出当前脚本已使用的内存大小
echo "已使用内存: " . round(memory_get_usage() / 1024 / 1024, 2) . "MB" . PHP_EOL;

通过访问这个文件，就能看到当前生效的内存限制值，以及程序运行时的内存占用情况，方便判断是需要调整配置，还是程序本身存在内存泄漏问题。

二、临时调整单个脚本的内存限制

如果只是单个PHP脚本需要更大的内存，不需要全局修改PHP配置，可以在脚本开头通过代码临时调整，这种方式只对当前脚本生效，不会影响其他程序的运行。

<?php
// 临时将当前脚本的内存限制调整为512M，单位可以是K（千字节）、M（兆字节）、G（吉字节）
ini_set('memory_limit', '512M');

// 后续的业务逻辑代码
// ...

这种方式的优点是灵活，不会影响全局配置，适合临时处理单个特殊脚本的内存需求，修改后立即生效，不需要重启服务。

三、修改PHP全局配置文件调整内存限制

如果需要全局调整PHP的内存限制，让所有PHP脚本都生效，就需要修改PHP的配置文件。Ubuntu系统中PHP的配置文件路径根据PHP版本不同有所区别，常见的路径如下：

• PHP 7.4：/etc/php/7.4/cli/php.ini（命令行模式）、/etc/php/7.4/fpm/php.ini（PHP-FPM模式）
• PHP 8.1：/etc/php/8.1/cli/php.ini（命令行模式）、/etc/php/8.1/fpm/php.ini（PHP-FPM模式）

首先通过命令查看当前系统安装的PHP版本，找到对应的配置文件：

# 查看已安装的PHP版本
php -v
# 如果是PHP-FPM模式，可以查看fpm的服务状态确认版本
systemctl status php*-fpm

找到对应的php.ini文件后，用编辑器打开，搜索memory_limit参数，修改对应的值：

; 原来的默认值可能是128M，根据需求调整为更大的值，比如512M或者1G
memory_limit = 512M

修改完成后，需要根据你使用的PHP运行模式重启对应的服务：

• 如果是命令行模式（CLI），不需要重启服务，下次执行PHP脚本就会生效
• 如果是PHP-FPM模式，执行重启命令：systemctl restart php7.4-fpm（替换成你实际使用的PHP版本）
• 如果是Apache模式，执行重启命令：systemctl restart apache2

四、针对Nginx+PHP-FPM环境的额外检查

如果你的环境是Nginx搭配PHP-FPM，除了修改PHP的php.ini配置，还需要检查PHP-FPM的池配置（pool config），有时候池配置里的内存限制会覆盖全局配置。

PHP-FPM的池配置文件通常在/etc/php/版本/fpm/pool.d/www.conf，打开文件搜索是否有php_admin_value[memory_limit]相关的配置：

; 如果存在这行配置，也需要同步修改，或者注释掉让全局配置生效
; php_admin_value[memory_limit] = 128M

修改完成后同样需要重启PHP-FPM服务让配置生效。

五、排查程序本身的内存泄漏问题

如果调整了内存限制之后，程序还是频繁出现内存超出的问题，就需要排查程序本身是否存在内存泄漏。比如循环中不断拼接大数组、未及时释放大对象、递归调用过深等情况，都会导致内存占用不断升高。

可以在程序中添加内存监控代码，定位内存占用升高的位置：

<?php
// 监控某段代码的内存占用变化
$startMemory = memory_get_usage();
// 需要监控的业务代码段
$largeArray = [];
for ($i = 0; $i < 100000; $i++) {
    $largeArray[] = str_repeat('a', 1024);
}
$endMemory = memory_get_usage();
echo "代码段内存占用增加: " . round(($endMemory - $startMemory) / 1024 / 1024, 2) . "MB" . PHP_EOL;
// 及时释放不需要的大变量
unset($largeArray);

通过分段监控内存变化，就能找到内存占用异常的位置，针对性优化程序逻辑，比单纯调大内存限制更能从根源解决问题。

六、注意事项

• 内存限制不是越大越好，设置过大的内存限制可能会导致服务器内存被耗尽，影响其他服务运行，建议根据实际需求设置合理的值。
• 修改配置文件前最好先备份原文件，避免修改出错后无法恢复。
• 如果是在生产环境调整配置，建议先在测试环境验证，避免影响线上服务。

PHP内存限制Ubuntumemory_limitPHP-FPM内存泄漏排查