☰
WORDPRESS / PRACTICE

Як діагностувати вичерпання PHP-пам’яті у WordPress

Як діагностувати вичерпання PHP-пам’яті у WordPress

Помилка `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 із реальною оперативною пам’яттю сервера.

← Усі матеріали WordPress