☰
WORDPRESS / PRACTICE

Оптимізація WP_Query без зайвого навантаження на MySQL

Оптимізація WP_Query без зайвого навантаження на MySQL

Повільний WP_Query не завжди означає, що база даних WordPress потребує термінової оптимізації. Часто запит працює довше через те, що код отримує повні об’єкти записів, завантажує непотрібні метадані та додатково рахує загальну кількість результатів.

Для службових вибірок, REST endpoint’ів, фонових задач і адміністративних звітів достатньо запитувати лише ті дані, які реально використовуються. Правильно підібрані параметри WP_Query зменшують обсяг обробки в PHP, кількість операцій із кешем і навантаження на MySQL.

Спочатку визначте, які дані дійсно потрібні

Перед оптимізацією перевірте, що відбувається з результатом запиту. Якщо код лише перевіряє наявність записів, формує список ID або передає ідентифікатори в іншу функцію, завантажувати повні об’єкти WP_Post немає сенсу.

Повний результат може спричинити додаткове використання пам’яті та звернення до кешів постів, метаданих і таксономій. Для невеликої вибірки це непомітно, але у фоновому процесі або на сайті з великою кількістю записів різниця стає суттєвою.

Зручне правило: спочатку визначте формат результату, кількість записів і пов’язані дані, а вже потім формуйте параметри WP_Query.

  • Потрібні лише ID — використовуйте fields => 'ids'.
  • Потрібно перевірити наявність записів — обмежте вибірку одним записом.
  • Потрібні поля поста для шаблону — не вимикайте кеші, які далі використовуються.
  • Потрібна пагінація — не вимикайте підрахунок результатів без розуміння наслідків.

Мінімальна конфігурація WP_Query для службової вибірки

Для задачі, де потрібно отримати ID опублікованих товарів, можна використати такий набір параметрів:

$query = new WP_Query([
    'post_type'              => 'product',
    'post_status'            => 'publish',
    'posts_per_page'         => 50,
    'fields'                 => 'ids',
    'no_found_rows'          => true,
    'update_post_meta_cache' => false,
    'update_post_term_cache' => false,
]);

$product_ids = $query->posts;

Що робить кожен параметр

fields => 'ids' змінює формат результату: властивість posts міститиме масив ідентифікаторів, а не повних об’єктів постів. Це особливо доречно для синхронізації, перевірок, масових оновлень і передачі ID в інші процеси.

no_found_rows => true вимикає підрахунок загальної кількості знайдених записів. За замовчуванням WordPress готує дані для found_posts і max_num_pages, що потрібні для пагінації. Якщо загальна кількість не використовується, цей підрахунок є зайвою роботою.

update_post_meta_cache => false і update_post_term_cache => false не дають WordPress наперед завантажувати метадані та терміни для отриманих постів. Ці прапорці корисні лише тоді, коли код після запиту не звертається до таких даних.

  • Параметри кешу не прискорюють кожен запит автоматично — вони доречні лише для відповідного сценарію.
  • Якщо після вибірки викликається get_post_meta() для багатьох записів, вимкнення кешу може спричинити багато окремих звернень до бази.
  • Після використання fields => 'ids' не можна очікувати, що елементи $query->posts будуть об’єктами WP_Post.

Коли не можна використовувати no_found_rows

no_found_rows => true не слід застосовувати, якщо сторінці потрібно показати загальну кількість записів, кількість сторінок або коректні елементи пагінації. У такому випадку WordPress не матиме повних значень для found_posts і max_num_pages.

Параметр можна залишити вимкненим для звичайного списку з пагінацією. Якщо загальна кількість результатів не потрібна, але записи все одно обробляються сторінками у фоновій задачі, no_found_rows => true зазвичай доречний.

Важливо розрізняти пагінацію інтерфейсу та пакетну обробку. Для інтерфейсу часто потрібна кількість сторінок, а для імпорту чи очищення даних достатньо отримувати черговий пакет і перевіряти, чи він не порожній.

  • Потрібні max_num_pages або found_posts — не вимикайте підрахунок.
  • Потрібна лише чергова порція записів — no_found_rows => true може зменшити зайву роботу.
  • Не покладайтеся на max_num_pages у коді, де no_found_rows встановлено в true.

Пакетна обробка замість posts_per_page => -1

Параметр posts_per_page => -1 змушує WordPress отримати всі відповідні записи одразу. На невеликому сайті це може залишитися непомітним, але для великої таблиці призводить до значного обсягу даних, високого використання пам’яті та довгого виконання PHP-коду.

Для масових операцій використовуйте пакети, наприклад по 50, 100 або 500 записів. Точний розмір залежить від складності обробки, кількості метаданих і доступних ресурсів сервера.

  • Обмежуйте кількість записів у кожному запиті.
  • Після кожного пакета звільняйте непотрібні великі масиви або об’єкти.
  • Для довгих задач зберігайте прогрес, щоб процес можна було продовжити після збою.
  • Не запускайте важку обробку в одному HTTP-запиті, якщо вона може перевищити ліміти часу виконання.
$page = 1;
$batch_size = 100;

while (true) {
    $query = new WP_Query([
        'post_type'              => 'product',
        'post_status'            => 'publish',
        'posts_per_page'         => $batch_size,
        'paged'                  => $page,
        'fields'                 => 'ids',
        'no_found_rows'          => true,
        'update_post_meta_cache' => false,
        'update_post_term_cache' => false,
    ]);

    if (!$query->posts) {
        break;
    }

    foreach ($query->posts as $post_id) {
        // Обробка одного запису.
    }

    $page++;
}

paged чи останній ID

Параметр paged простий у використанні, але на дуже великих обсягах перехід до далеких сторінок може ставати дорожчим для MySQL, оскільки база пропускає попередні рядки. Також під час зміни набору даних між пакетами можливі пропуски або повторна обробка.

Підхід із останнім обробленим ID, відомий як keyset pagination, може бути ефективнішим. Проте WP_Query не має універсального стандартного параметра для умови ID > останній_ID у всіх сценаріях. Для нього часто потрібен ретельно підготовлений SQL через $wpdb або спеціальна структура вибірки з гарантовано стабільним сортуванням. Не використовуйте цей підхід без перевірки коректності порядку та умов.

  • Для звичайних пакетів і невеликої кількості сторінок достатньо paged.
  • Для великих черг обробки розгляньте keyset pagination.
  • Сортування має бути стабільним: наприклад, за ID або іншою унікальною комбінацією полів.

Кеш метаданих і таксономій: вимикати чи залишати

WP_Query може попередньо завантажувати метадані та терміни для отриманих постів. Це зручно для сторінки, де кожен запис одразу виводиться разом із custom fields і категоріями. Але для вибірки ID або перевірки базових властивостей така підготовка даних не потрібна.

Вимикайте update_post_meta_cache та update_post_term_cache лише після перевірки подальшого коду. Якщо в циклі викликаються get_post_meta(), get_the_terms() або функції, які залежать від цих даних, повне вимкнення кешування може збільшити кількість запитів.

У деяких сценаріях краще не вимикати кеш, а отримувати необхідні дані більш передбачувано: наприклад, обмежити поля, кількість записів або перенести повторювану логіку за межі циклу.

  • Тільки ID та службові перевірки — кеші мета й термінів часто можна вимкнути.
  • Виведення карток товарів або записів — кеші можуть бути корисними.
  • Не оцінюйте параметри ізольовано: дивіться на весь код після виконання WP_Query.

Метазапити, сортування та інші дорогі умови

Навіть оптимальний формат результату не усуне проблеми, якщо сам запит містить складні умови. Найбільше уваги потребують meta_query, tax_query, сортування за метаполем, великі списки post__in і використання offset на значних обсягах.

Метаполя WordPress зберігаються в окремій таблиці, тому фільтрація та сортування за ними можуть бути дорожчими, ніж вибірка за стандартними полями поста. Якщо одна й та сама ознака регулярно використовується в критичних запитах, варто перевірити структуру даних і фактичний план виконання, а не просто додавати нові умови.

Не змінюйте SQL або індекси навмання. Спочатку зафіксуйте реальний повільний запит, перевірте його в інструменті профілювання та переконайтеся, що вузьке місце справді пов’язане з MySQL.

  • Не використовуйте зайві meta_query та tax_query.
  • Не сортуйте за метаполем, якщо це не потрібно користувачу або бізнес-логіці.
  • Обережно застосовуйте offset для великих наборів даних.
  • Перевіряйте не лише час SQL-запиту, а й пам’ять та час подальшої обробки в PHP.

Як перевірити, що оптимізація справді допомогла

Оптимізацію слід оцінювати на реальному сценарії, а не лише за виглядом коду. Порівняйте стару й нову версію запиту з однаковими параметрами, кількістю записів і умовами фільтрації.

Перевірте, чи не змінився функціональний результат: кількість записів, порядок, обробка статусів і поведінка пагінації. Окремо протестуйте ситуацію, коли результат порожній, містить один запис або досягає ліміту пакета.

Для діагностики можуть використовуватися інструменти профілювання WordPress, журнали повільних запитів MySQL і моніторинг PHP. У production-середовищі не вмикайте детальне логування без контролю його обсягу та впливу на сайт.

  • Порівняйте кількість і час SQL-запитів.
  • Перевірте використання пам’яті під час одного пакета.
  • Переконайтеся, що кеші не вимкнені там, де вони потрібні.
  • Перевірте поведінку при паралельному запуску кількох фонових задач.
  • Переконайтеся, що відсутність found_rows не ламає пагінацію або звіти.

Типові помилки під час оптимізації WP_Query

Найпоширеніша помилка — механічно додати всі прапорці оптимізації, не перевіривши, як використовується результат. Це може формально зменшити роботу одного запиту, але створити багато додаткових звернень до бази в наступному циклі.

Інша проблема — заміна пакетної обробки на posts_per_page => -1, щоб спростити код. Такий підхід часто працює на тестових даних і створює аварійне навантаження після зростання таблиці.

Також не варто оптимізувати лише SQL і забувати про зовнішні API, складні обчислення, повторні виклики функцій та відсутність контролю прогресу у фонових задачах.

  • Не вимикайте no_found_rows, якщо потрібна кількість сторінок.
  • Не використовуйте fields => 'ids', якщо далі код очікує WP_Post.
  • Не вимикайте кеші метаданих без перевірки get_post_meta() та споріднених викликів.
  • Не запускайте необмежену вибірку у cron, REST або адміністративному звіті.
  • Не робіть висновок про ефект без тесту на обсязі даних, близькому до production.

Поширені запитання

Чи потрібно завжди встановлювати fields => 'ids'?

Ні. Цей параметр доречний, коли потрібні лише ідентифікатори. Якщо код виводить заголовок, дату, контент або інші властивості поста, використовуйте відповідний формат результату й не ламайте подальшу логіку.

Чи можна поєднувати no_found_rows => true з paged?

Так, записи можна отримувати сторінками, але WordPress не розраховуватиме повну кількість результатів і сторінок. Це підходить для пакетної обробки, але не для інтерфейсу, якому потрібна коректна пагінація.

Чи завжди вимкнення кешу метаданих зменшує навантаження?

Ні. Якщо після запиту код читає метадані для кожного запису, вимкнення попереднього кешування може призвести до великої кількості окремих запитів. Рішення залежить від того, які дані реально використовуються.

Чому posts_per_page => -1 небезпечний для великих таблиць?

WordPress намагатиметься отримати всі відповідні записи за один раз. Це збільшує обсяг даних, використання пам’яті та час виконання. Для великих наборів безпечніше працювати пакетами.

Коли варто переходити від paged до вибірки за останнім ID?

Коли обсяг даних великий, процес проходить багато сторінок, а набір записів має стабільний порядок. Така схема потребує коректної умови вибірки й часто реалізується через власний SQL, тому її потрібно тестувати окремо.

Висновок

Оптимізація WP_Query починається не з додавання складних індексів, а з перевірки того, які дані справді потрібні коду. Для службових вибірок зазвичай достатньо отримувати ID, вимикати непотрібний підрахунок результатів і не завантажувати метадані та терміни без потреби.

Великі набори слід обробляти пакетами, а запити з meta_query, сортуванням і пагінацією — перевіряти на реальних даних. Такий підхід зменшує ризик перевантаження MySQL і робить фонові задачі, REST endpoint’и та адміністративні звіти стабільнішими.

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