Технологічна галузь

WordPress Cron не працює? Як виправити заплановані завдання та пропущені пости

WordPress Cron Not Working? How to Fix Scheduled Tasks and Missed Posts

Заплановані пости WordPress не публікуються? Дізнайтеся, як діагностувати проблеми WP-Cron, перевірити заплановані події, виправити помилки loopback і налаштувати надійний серверний cron-завдання крок за кроком.

WordPress Cron не працює? Як виправити заплановані завдання та пропущені публікації

Ви запланували публікацію статті у WordPress на 9:00. О 9:30 вона досі не з’явилася.

Або, можливо, ваші листи WooCommerce надходять із запізненням, заплановані резервні копії ніколи не запускаються, чи плагін повідомляє, що його фонові завдання прострочені.

Ці проблеми часто мають дещо спільне: WP-Cron, вбудована система планування завдань WordPress.

WP-Cron зручний, оскільки працює без потреби доступу до планувальника завдань вашого хостингового сервера. Але, на відміну від традиційного системного cron-завдання, він не працює безперервно у фоновому режимі.

У цьому посібнику ви дізнаєтеся, як працює WP-Cron, як визначити причину затримки завдань і як за потреби замінити його стандартний механізм запуску надійним серверним cron-завданням.

Ми розглянемо як спільний хостинг, так і сервери з доступом до командного рядка.

1. Як насправді працює WP-Cron

Традиційний демон cron у Linux перевіряє свій розклад незалежно від відвідуваності сайту.

WP-Cron працює інакше. WordPress перевіряє заплановані завдання під час звичайної активності сайту й, коли це доречно, намагається запустити запит до wp-cron.php.

Це означає, що запланована подія не гарантовано виконається точно в запланований час.

Уявіть сайт, останній відвідувач якого заходить о 22:00. Резервну копію заплановано на 2:00, але вночі ніхто не відвідує сайт.

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

Чим відрізняються два методи планування

Стандартний WP-Cron: запит відвідувача → WordPress перевіряє події → запускаються завдання, час яких настав. Це залежить від запитів до WordPress.

Серверний cron: серверний планувальник → запускається кожні п’ять хвилин → запускаються завдання, час яких настав. Він працює незалежно від відвідуваності.

Серверне cron-завдання не змінює спосіб, у який WordPress зберігає заплановані події. Воно просто забезпечує передбачуваніший спосіб їх перевіряти й виконувати.

2. Розпізнайте симптоми, перш ніж щось змінювати

Не кожна затримка операції WordPress спричинена WP-Cron.

Почніть із визначення фактичного симптому.

Симптом Можливе пояснення
Заплановані публікації показують "Missed schedule" Запуск cron затримано або не вдалося
Заплановані листи надходять із запізненням Затримка cron, обробка черги або проблема з доставкою пошти
Автоматичні резервні копії ніколи не запускаються Відсутня подія, збій cron або помилка плагіна резервного копіювання
Дії WooCommerce залишаються в очікуванні Проблема обробки Action Scheduler
Site Health повідомляє про помилку loopback WordPress не може надійно звернутися до власної URL-адреси
Завдання запускаються лише після відвідування сайту Запуск cron залежить від трафіку

Важлива різниця між завданням, яке ніколи не запускається, і завданням, яке запускається, але зазнає збою.

Заміна WP-Cron на серверний планувальник може розв’язати першу проблему. Вона не відремонтує автоматично зламаний плагін, недоступну базу даних або збійну службу електронної пошти.

3. Спочатку перевірте WordPress Site Health

Перш ніж торкатися файлів конфігурації, відкрийте інтерфейс адміністрування WordPress.

  1. Перейдіть до Інструменти → Здоров’я сайту.
  2. Відкрийте вкладку Статус.
  3. Знайдіть попередження, пов’язані із запланованими подіями або loopback-запитами.
  4. Запишіть точне повідомлення перед внесенням змін.

Loopback-запит — це запит, який WordPress робить до власного сайту.

Якщо ці запити зазнають збоїв, заплановані завдання можуть не запускатися належним чином.

Поширені причини включають неправильну URL-адресу сайту, проблеми з розв’язанням DNS, проблеми із SSL-сертифікатом, HTTP-автентифікацію, обмеження брандмауера або конфлікти з плагінами й темами.

Приклад: staging-сайт, захищений паролем

Припустімо, ви створили staging-середовище WordPress за адресою:

https://staging.example.com

Staging-сайт вимагає базової HTTP-автентифікації.

WordPress намагається звернутися до власної кінцевої точки wp-cron.php, але сервер повертає HTTP 401, оскільки запит не автентифіковано.

Проблема не обов’язково в самому запланованому завданні. Запит, який мав би запустити завдання, відхиляється.

У цій ситуації можна використати серверний CLI-планувальник, який уникає публічного HTTP loopback-маршруту, або налаштувати середовище так, щоб внутрішні запити WordPress працювали правильно.

Не знімайте парольний захист зі staging-сайту лише для того, щоб cron працював.

4. Перегляньте заплановані завдання за допомогою WP-CLI

Якщо у вас є SSH-доступ і встановлено WP-CLI, ви можете переглянути планувальник безпосередньо.

Спочатку перейдіть до каталогу встановлення WordPress.

cd /path/to/wordpress

Потім перелічіть заплановані події:

wp cron event list

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

Для машинозчитуваного виводу:

wp cron event list --fields=hook,next_run_gmt,recurrence --format=json

На що слід звернути увагу?

Зверніть увагу на події, наступний час виконання яких уже минув.

Прострочена подія є корисною попереджувальною ознакою, але одна прострочена подія сама по собі не доводить, що весь планувальник зламано.

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

Illustration of the article's main concept

Якщо уражено події лише одного плагіна, спершу перевірте цей плагін.

Запустіть завдання, час яких настав, вручну

У staging-середовищі або після підтвердження наслідків у production виконайте:

wp cron event run --due-now

Це просить WordPress виконати події, час яких наразі настав.

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

Це не безпечний діагностичний попередній перегляд.

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

5. Замініть залежний від трафіку WP-Cron на серверне cron-завдання

Для production-сайту, де заплановані завдання мають значення, серверне cron-завдання часто є кращим вибором.

Мета проста:

  • Змусити WordPress припинити намагатися автоматично запускати WP-Cron під час звичайних запитів до сторінок.
  • Попросити сервер обробляти події, час яких настав, через регулярні інтервали.

Крок 1: відредагуйте wp-config.php

Зробіть резервну копію wp-config.php.

Додайте цю конфігурацію перед рядком, який каже зупинити редагування:

define('DISABLE_WP_CRON', true);

Це вимикає стандартний автоматичний запуск cron у WordPress. Це не видаляє заплановані події, збережені WordPress.

Крок 2: створіть заплановане завдання на вашому хостинговому сервері

Відкрийте панель керування хостингом і знайдіть планувальник cron-завдань.

Для стандартного встановлення WordPress ви можете запланувати команду PHP CLI, подібну до:

/usr/bin/php /home/account/public_html/wp-cron.php

Замініть як шлях до виконуваного файлу PHP, так і шлях до встановлення WordPress фактичними значеннями, наданими вашим хостом.

Команда має запускати правильну версію PHP і мати дозвіл на читання файлів WordPress.

Якщо встановлено WP-CLI, інший варіант:

cd /home/account/public_html && /usr/local/bin/wp cron event run --due-now

Ця альтернатива явно обробляє події WordPress, час яких настав, через WP-CLI.

Використовуйте один метод планування для заданого встановлення, а не налаштовуйте кілька незалежних cron-завдань для виконання тієї самої роботи.

Крок 3: виберіть відповідний інтервал

Для типового сайту п’ять хвилин є розумною відправною точкою.

Інтервал виконання Викликів планувальника на день Максимальна затримка опитування* Приклад виразу crontab
1 хвилина 1 440 1 хвилина * * * * *
5 хвилин 288 5 хвилин */5 * * * *
10 хвилин 144 10 хвилин */10 * * * *
15 хвилин 96 15 хвилин */15 * * * *
30 хвилин 48 30 хвилин */30 * * * *

*Передбачає працездатний планувальник і нетривалі завдання. Фактичне виконання може затримуватися через навантаження сервера або тривалі callback-функції.

Наприклад, кожні п’ять хвилин:

*/5 * * * *

Інтервал в одну хвилину забезпечує частіші перевірки, але не є необхідним для кожного сайту.

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

Крок 4: перевірте результат

Після налаштування серверного завдання зачекайте щонайменше два заплановані інтервали.

Потім знову перегляньте список подій:

wp cron event list

Переконайтеся, що раніше прострочені події було оброблено.

Також перевірте журнали cron хостингу.

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

6. Що робити, якщо ваш хост не надає SSH-доступ?

Ви все ще можете налаштувати серверне cron-завдання на багатьох тарифах спільного хостингу.

Деякі панелі хостингу підтримують запланований URL-запит, наприклад:

https://example.com/wp-cron.php

Інші пропонують виконання команд PHP без надання інтерактивного SSH-термінала.

Надавайте перевагу завданню PHP CLI, коли воно підтримується. На запланований HTTP-запит можуть впливати перенаправлення, обмеження доступу, правила безпеки або проблеми мережі.

Якщо ваша панель хостингу підтримує лише HTTP-запити, переконайтеся, що кінцева точка доступна й що запит справді запускає завдання, час яких настав.

Не припускайте, що отримання відповіді HTTP 200 доводить успішне завершення всіх запланованих callback-функцій.

Technical workflow illustration

7. Створіть безпечну тестову подію

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

Створіть цей файл:

wp-content/plugins/ceikay-cron-test/ceikay-cron-test.php

Додайте:

<?php
/**
 * Plugin Name: CeiKay Cron Test
 * Description: Temporary diagnostic cron event.
 */

if (!defined('ABSPATH')) {
    exit;
}

add_action('ceikay_cron_test', function () {
    error_log(
        'CeiKay cron test executed at ' .
        gmdate('Y-m-d H:i:s') .
        ' UTC'
    );
});

register_activation_hook(__FILE__, function () {
    if (!wp_next_scheduled('ceikay_cron_test')) {
        wp_schedule_event(
            time() + 60,
            'hourly',
            'ceikay_cron_test'
        );
    }
});

register_deactivation_hook(__FILE__, function () {
    wp_clear_scheduled_hook('ceikay_cron_test');
});

Активуйте плагін через інтерфейс адміністрування WordPress.

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

Перша подія планується приблизно через одну хвилину після активації.

Щоб перевірити її одразу після активації за допомогою WP-CLI:

wp cron event run ceikay_cron_test

Перевірте журнал помилок PHP на повідомлення, подібне до:

CeiKay cron test executed at 2026-11-18 07:30:00 UTC

Позначка часу є лише прикладом.

Якщо ви бажаєте перевірити автоматичний планувальник, а не виконувати хук вручну, зачекайте, доки настане час події, і дозвольте налаштованому механізму cron обробити її.

Коли тестування завершено, деактивуйте й видаліть діагностичний плагін.

8. Усунення несправностей: cron-завдання запускається, але завдання все одно зазнають збоїв

Працездатний тригер cron — це лише одна частина системи.

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

Проблема Що перевірити Рекомендована дія
Заплановані події не перелічено Плагін міг не зареєструвати свій хук Перевірте активацію плагіна й код планування
Події залишаються простроченими Серверне завдання може не виконуватися Перевірте журнали cron, шлях до PHP і дозволи
Фатальна помилка PHP Збій callback-функції завдання або плагіна Перегляньте журнали помилок PHP і трасування стеку
HTTP 401 або 403 Автентифікація або брандмауер Перегляньте обмеження доступу loopback
HTTP 500 Збій застосунку або сервера Перегляньте журнали PHP/сервера
Події виконуються, але листи не надходять Проблема транспорту пошти Перевірте SMTP або журнали доставки електронної пошти
Дубльовані виконання Дубльовані розклади або процеси, що перекриваються Перегляньте хуки, аргументи й блокування
Дії WooCommerce залишаються в очікуванні Накопичення Action Scheduler Перегляньте інтерфейс запланованих дій та окремі збої

Не видаляйте прострочені події наосліп

Може виникнути спокуса видалити кожну подію, яка виглядає застряглою.

Уникайте цього.

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

Видалення події може прибрати заплановану роботу, не виправивши основну проблему.

WP-CLI надає команди для видалення подій, але їх слід використовувати лише після визначення хука й розуміння його призначення.

9. Уникайте дубльованих запланованих подій у власних плагінах

Якщо ви розробляєте плагін WordPress, поширеною помилкою є повторна реєстрація тієї самої повторюваної події.

Наприклад, планування завдання під час кожного завантаження сторінки без перевірки, чи воно вже існує.

Правильний підхід — спершу перевірити:

if (!wp_next_scheduled('myplugin_daily_cleanup')) {
    wp_schedule_event(
        time() + HOUR_IN_SECONDS,
        'daily',
        'myplugin_daily_cleanup'
    );
}

Потім окремо зареєструвати callback-функцію:

add_action('myplugin_daily_cleanup', function () {
    // Perform a small, bounded maintenance task.
});

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

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

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

10. Практичний контрольний список для надійного планувальника WordPress

Перш ніж вважати проблему вирішеною, перевірте ці пункти:

  • [ ] WordPress Site Health не показує нез’ясованих помилок планування або loopback.
  • [ ] Очікувані заплановані хуки існують.
  • [ ] Серверний cron виконується з належним інтервалом.
  • [ ] DISABLE_WP_CRON налаштовано лише після того, як альтернативний тригер готовий.
  • [ ] Cron-завдання використовує правильний виконуваний файл PHP і шлях до WordPress.
  • [ ] Реальне заплановане завдання успішно завершується.
  • [ ] Журнали можна переглянути, коли завдання зазнає збою.
  • [ ] Не активовано дубльовану конфігурацію планувальника.
  • [ ] Критичні операції мають власний моніторинг або сповіщення про збої.

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

11. Остаточні думки: коли варто використовувати серверний cron?

Для невеликого особистого блогу з випадковими відвідувачами й без чутливої до часу автоматизації стандартний WP-Cron може бути цілком достатнім.

Але якщо ваш сайт покладається на заплановану публікацію, фонове обслуговування, обробку електронної комерції або інші повторювані операції, варто розглянути серверне cron-завдання.

Покращення не в тому, що серверний cron магічно робить кожен плагін WordPress надійним. Він усуває одне важливе джерело невизначеності: залежність від вхідних запитів до сайту для запуску подій, час яких настав.

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

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