PHP: «Allowed memory size of … bytes exhausted» — как исправить

#Что означает ошибка

Директива memory_limit ограничивает память, которую может использовать один запрос PHP. Значение в сообщении — текущий лимит в байтах (134217728 — это 128 МБ, 268435456 — 256 МБ). Число «tried to allocate» — лишь последняя порция, которая не поместилась, а не весь объём, нужный скрипту. Важнее путь к файлу и номер строки: они показывают, где память закончилась.

#Причины и решения

#Пошаговое решение

1. Прочитайте файл и строкуНайдите полное сообщение Allowed memory size of ... bytes exhausted в журнале PHP или журнале приложения. Запишите имя файла и номер строки, размер указанного лимита и операцию, при которой это случилось (импорт, генерация отчёта, загрузка изображения). Перед правкой сохраните копию затронутого файла или конфигурации. Число после tried to allocate — это размер последнего запрошенного участка, а не общий объём потребления. Если ошибка возникает на любом объёме данных, ищите бесконечный цикл или повторную загрузку набора, а не только увеличивайте память.
2. Проверьте лимитОпределите, какая версия PHP обрабатывает именно ошибочный запрос. Для командной строки выполните php -v и php -i | grep memory_limit на Linux либо php -i | findstr memory_limit в Windows — это только CLI. Для веб-сайта проверьте активную версию и ограничения нужного пула PHP-FPM в панели хостинга и его конфигурации; настройки CLI могут отличаться. Если временно используете phpinfo(), ограничьте к нему доступ и сразу удалите проверочный файл, поскольку он раскрывает параметры сервера. Запишите текущую директиву memory_limit и возможные пределы контейнера/пула.
3. Оцените потреблениеЕсли есть доступ к коду, определите, не загружает ли запрос весь массив или таблицу одновременно. Включите подробный журнал в тестовой среде и добавьте временные записи memory_get_usage(true) и memory_get_peak_usage(true) до и после подозрительного участка. Для PDO замените fetchAll() на построчную обработку при подходящем драйвере; для больших файлов используйте потоковое чтение; для изображений проверяйте реальные размеры растра. Если память растёт бесконечно, исправьте логику и протестируйте на копии данных: повышение лимита лишь отложит падение.
4. Увеличьте лимитТолько если операция объективно требует больше памяти и сервер располагает запасом, администратор может повысить memory_limit для нужной среды: например, с 128M до 256M в конфигурации конкретного PHP-FPM-пула или панели хостинга. Сохраните предыдущее значение, проверьте конфигурацию и согласованно перезагрузите соответствующий PHP-FPM, не все службы без необходимости. Учитывайте число параллельных процессов: лимит применяется к каждому процессу PHP, а общий расход может превысить RAM. Повторите исходный запрос и посмотрите журнал и пиковую память; не задавайте -1 на рабочем сайте.
5. Команды для отдельных ситуацийВыберите только подходящий вариант. Это не одна последовательность: часть команд диагностирует проблему, а часть меняет настройки или данные.
   Выберите подходящий вариант — это не команды для последовательного выполнения

   Вариант 1Диагностика только CLI на Linux; для Windows замените grep на findstr.

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Диагностика только CLI на Linux; для Windows замените grep на findstr. Настройки сайта в PHP-FPM могут отличаться.

   php --ini

   php -v

   php -i | grep -i memory_limit

   Вариант 2Путь зависит от системы: например, /etc/php/8.3/fpm/php.ini для PHP-FPM в Debian/Ubuntu.

   php.iniКопировать всёВыделить

   Путь зависит от системы: например, /etc/php/8.3/fpm/php.ini для PHP-FPM в Debian/Ubuntu. После правки перезапустите PHP-FPM.

   memory_limit = 256M

   Вариант 3Генератор отдаёт строки по одной — память не растёт с размером таблицы.

   пример порционной обработкиКопировать всёВыделить

   Генератор отдаёт строки по одной — память не растёт с размером таблицы.

   <?php
   function rows(PDO $pdo): Generator {
       $st = $pdo->query('SELECT * FROM big_table');
       while ($row = $st->fetch(PDO::FETCH_ASSOC)) {
           yield $row;   // по одной строке, без загрузки всей таблицы
       }
   }

В WordPress для лимита, который использует сама система, можно задать в wp-config.php: define('WP_MEMORY_LIMIT', '256M');. Но если лимит упирается в memory_limit сервера, поднимать нужно и его.

#Как проверить результат

• Тяжёлая операция выполняется без фатальной ошибки.
• Потребление памяти не растёт линейно с размером данных.
• В журнале ошибок PHP нет новых записей Allowed memory size.

#Если не помогло

Включите профилирование (например, Xdebug или memory_get_peak_usage()) в проблемном месте и найдите, какой участок растёт. Для CMS отключите плагины по одному и посмотрите, при каком исчезает ошибка. Если нагрузка выросла, возможно, нужен более мощный тариф или оптимизация запросов.