Ошибка `Allowed memory size exhausted` означает, что PHP-процесс достиг установленного лимита памяти. В этот момент WordPress не может завершить текущий запрос и аварийно завершает его с фатальной ошибкой. Причиной может быть не только слабый сервер: память часто исчерпывает конкретный плагин, импорт, резервное копирование, сложный административный запрос или обработка большого количества записей.
Правильная диагностика начинается не со слепого увеличения лимита, а с определения контекста проблемы: возникает ли ошибка на сайте, в панели администратора, во время WP-CLI-команды или только в PHP-FPM. Ниже приведена последовательность проверок, которая поможет отделить ограничение конфигурации от ошибки в коде или чрезмерной нагрузки.
Что именно означает ошибка нехватки памяти
В PHP есть параметр `memory_limit`, который ограничивает объём памяти для одного процесса. Если скрипт пытается выделить больше памяти, PHP выводит сообщение вида `Allowed memory size of ... bytes exhausted`. Обычно в нём указаны текущий лимит и дополнительный объём памяти, который процесс пытался получить.
Это ограничение действует для отдельного PHP-процесса, а не для всего сервера. Даже если один запрос укладывается в лимит, одновременная работа множества PHP-FPM-процессов может исчерпать физическую оперативную память или привести к использованию swap.
Ошибка может появляться только на определённой странице или во время конкретной операции. Например, обычные страницы открываются, но завершается с ошибкой импорт товаров, страница редактирования большого заказа, генерация отчёта или запуск резервного копирования.
- Лимит PHP ниже, чем требуется WordPress или активным расширениям.
- Плагин или тема создаёт большой массив, запускает бесконечный цикл или выполняет слишком сложный запрос.
- Импорт обрабатывает все записи одновременно вместо пакетной обработки.
- В разных средах используются разные конфигурации PHP.
- На сервере одновременно работает слишком много PHP-FPM-процессов.
Проверьте лимиты PHP в нужном контексте
CLI, PHP-FPM и веб-запрос могут использовать разные версии PHP и разные файлы `php.ini`. Поэтому результат команды в терминале не всегда показывает лимит, который применяется к запросу из браузера.
Начните с проверки CLI и окружения WP-CLI:
- Сравните версию PHP, которую использует сайт и командная строка.
- Проверьте путь к активному `php.ini` через CLI.
- Уточните, не переопределяет ли хостинг параметры на уровне пула PHP-FPM или панели управления.
- Если проблема возникает только в браузере, проверяйте именно веб-конфигурацию, а не только CLI.
wp eval 'echo ini_get("memory_limit"), PHP_EOL;'
wp --info
php --ini
php -r 'echo ini_get("memory_limit"), PHP_EOL;'
Лимиты WordPress в wp-config.php
WordPress может запрашивать у PHP отдельные значения для обычных и административных запросов. Константы добавляют в `wp-config.php` до строки `/* That's all, stop editing! */`, если они ещё не определены:
- `WP_MEMORY_LIMIT` применяется к обычной работе WordPress.
- `WP_MAX_MEMORY_LIMIT` предназначен для административных операций, которым может потребоваться больше памяти.
- Эти константы не отменяют системный `memory_limit`: фактический результат зависит от конфигурации PHP и среды хостинга.
- Значения следует подбирать с учётом реального объёма оперативной памяти сервера, а не устанавливать максимально возможные.
define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');
Найдите момент и место сбоя в логах
Сначала определите, когда именно появилась ошибка: после обновления плагина, установки новой темы, смены версии PHP, запуска импорта или увеличения объёма данных. Сопоставьте время ошибки с записями веб-сервера, PHP-FPM и WordPress.
В сообщении о фатальной ошибке часто указываются файл и номер строки. Однако это не всегда точное место возникновения проблемы: PHP может завершить работу в ядре WordPress или библиотеке, хотя чрезмерное потребление памяти вызвал плагин, который запустил этот код.
Для временной диагностики можно включить журнал WordPress в конфигурации. На рабочем сайте не следует без необходимости показывать ошибки посетителям:
- Проверьте `error_log` PHP и журнал веб-сервера.
- Посмотрите журналы PHP-FPM, если проблема возникает только при веб-запросах.
- Обратите внимание на одинаковый URL, AJAX-запрос, cron-задачу или WP-CLI-команду, выполненные непосредственно перед сбоем.
- После диагностики отключите подробный режим debug или ограничьте доступ к журналам.
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Проверьте плагины, тему и последние изменения
Самый быстрый способ проверить влияние плагинов — временно отключить их и повторить проблемную операцию. Если доступна консоль, WP-CLI позволяет сделать это без входа в административную панель. Перед изменениями зафиксируйте список активных расширений и убедитесь, что у вас есть резервная копия.
Необязательно сразу отключать все плагины на рабочем сайте. Безопаснее проверять их группами: сначала расширения, работающие с импортом, товарами, редактором, кешем, резервными копиями или отчётами. Если после деактивации группы ошибка исчезает, включайте компоненты по одному, чтобы найти источник проблемы.
Если плагины не являются причиной, проверьте тему и функциональность в `functions.php`. Особое внимание уделите собственным фильтрам, обработчикам cron, REST-запросам и коду, который загружает все записи без ограничений.
- Посмотрите, какие плагины обновились непосредственно перед появлением ошибки.
- Проверяйте не только активные плагины, но и must-use plugins в каталоге `mu-plugins`.
- Сравните поведение на копии сайта в staging-среде.
- После тестирования верните необходимые плагины и зафиксируйте результат каждой проверки.
wp plugin list --status=active
wp plugin deactivate plugin-slug
wp plugin activate plugin-slug
Оптимизируйте импорты и большие запросы
Импорт часто становится причиной исчерпания памяти, когда код сначала загружает весь файл или все записи в один массив и только затем начинает обработку. Такой подход может работать на тестовом наборе данных, но завершаться ошибкой на реальном сайте.
Разделите операцию на небольшие пакеты. После обработки каждой порции освобождайте ненужные переменные, не накапливайте результаты в глобальном массиве и сохраняйте прогресс, чтобы импорт можно было продолжить после ошибки.
В запросах к WordPress избегайте неограниченного получения записей, например с параметром `posts_per_page => -1`, если данных много. Используйте пагинацию, ограничивайте поля, когда это возможно, и не запускайте несколько тяжёлых импортов параллельно.
Для больших операций лучше использовать пакетную обработку через WP-CLI или очередь задач, а не один длительный HTTP-запрос. Это также снижает риск тайм-аута и повторной обработки уже импортированных данных.
- Обрабатывайте CSV, XML или JSON частями, а не загружайте весь файл в память.
- Не храните результаты предыдущих пакетов в одной переменной.
- Проверьте сторонние API: ответ может содержать значительно больше данных, чем необходимо.
- В журнал следует записывать краткий прогресс, а не полное содержимое каждой записи.
Если проблема связана с PHP-FPM
Если ошибка возникает только при открытии сайта или административной панели, проверьте настройки PHP-FPM. Важен не только `memory_limit`, но и количество одновременных процессов, включая `pm.max_children`.
Высокий лимит памяти для одного процесса не означает, что сервер автоматически выделит этот объём каждому процессу. Однако несколько тяжёлых запросов могут одновременно использовать значительную часть RAM. Если процессов слишком много, сервер начинает обращаться к swap, медленно отвечает или завершает процессы из-за нехватки памяти.
Оценивайте настройки вместе с фактическим использованием RAM, количеством ядер, типом нагрузки и другими сервисами: базой данных, веб-сервером, cron и системой резервного копирования. Точные значения зависят от конфигурации сервера, поэтому их лучше изменять постепенно и контролировать по графикам и логам.
- Сравните потребление памяти при обычном трафике и во время проблемной операции.
- Проверьте, нет ли большого количества одновременно запущенных cron-задач или импортов.
- Не увеличивайте `pm.max_children`, если сервер уже работает на пределе доступной RAM.
- После изменений перезапустите PHP-FPM только в соответствии с правилами вашего хостинга и проверьте результат.
Типичные ошибки при исправлении проблемы
Увеличение `WP_MEMORY_LIMIT` может временно вернуть сайт к работе, но не устраняет утечку памяти, неэффективный запрос или ошибку плагина. Если причина сохраняется, проблема повторится при увеличении объёма данных или во время параллельных запросов.
Не следует редактировать случайный `php.ini`, не проверив, какой именно файл используется в нужном контексте. Также опасно добавлять несколько противоречащих друг другу определений `WP_MEMORY_LIMIT` в разные места конфигурации.
Не ограничивайтесь проверкой главной страницы: тестируйте именно действие, которое вызывает ошибку. После исправления повторите импорт, откройте проблемный экран и проверьте логи, чтобы убедиться, что ошибка не просто изменила форму.
- Не устанавливайте необоснованно большой лимит памяти.
- Не удаляйте записи из логов до определения причины.
- Не отключайте все плагины без плана восстановления и резервной копии.
- Не путайте лимит одного PHP-процесса с общим объёмом RAM сервера.
- Не запускайте тяжёлые операции одновременно в браузере, cron и WP-CLI.
Частые вопросы
Достаточно ли просто увеличить memory_limit?
Нет. Это может быть временной мерой, но сначала необходимо проверить логи, плагины, импорты и фактическую нагрузку. Если в коде есть утечка или он загружает все данные в память, проблема вернётся.
Почему WP-CLI показывает другой лимит памяти, чем сайт?
CLI и веб-запросы могут использовать разные версии PHP, файлы php.ini или настройки PHP-FPM. Проверяйте каждый контекст отдельно.
Можно ли установить WP_MEMORY_LIMIT на 1G?
Технически это зависит от конфигурации сервера, но без анализа RAM и количества PHP-процессов такое значение опасно. Оно может позволить одному запросу занять слишком много памяти и ухудшить работу всего сервера.
Как найти плагин, который вызывает ошибку?
Зафиксируйте список активных плагинов, временно отключайте их группами через WP-CLI или другим безопасным способом и повторяйте проблемное действие. Когда проблемная группа найдена, включайте плагины по одному.
Вывод
Диагностика ошибки `Allowed memory size exhausted` должна начинаться с определения контекста: веб-запрос, PHP-FPM, CLI или конкретная административная операция. После этого проверьте лимиты, журналы и изменения, которые предшествовали сбою.
Увеличение лимита памяти уместно только как часть решения. Стабильный результат обеспечивают пакетные импорты, контроль больших запросов, поиск проблемного плагина или кода, а также согласование настроек PHP-FPM с реальным объёмом оперативной памяти сервера.