Web a vývoj

WordPress Cron nefunguje? Jak opravit naplánované úlohy a zmeškané příspěvky

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

Naplánované příspěvky ve WordPressu se nezveřejňují? Zjistěte, jak diagnostikovat problémy s WP-Cron, zkontrolovat naplánované události, opravit chyby loopback a nakonfigurovat spolehlivý serverový cron job krok za krokem.

Naplánujete WordPress článek na 9:00 ráno. V 9:30 se stále neobjevil.

Nebo vaše WooCommerce e-maily dorazí pozdě, naplánované zálohy se nespustí, nebo plugin hlásí, že jeho úlohy na pozadí jsou zpožděné.

Tyto problémy často mají společnou příčinu: WP-Cron, vestavěný systém pro plánování úloh ve WordPressu.

WP-Cron je pohodlný, protože funguje bez nutnosti přístupu k plánovači úloh na vašem hostovacím serveru. Ale na rozdíl od tradičního systémového cron jobu neběží nepřetržitě na pozadí.

V této příručce se naučíte, jak WP-Cron funguje, jak identifikovat příčinu zpožděných úloh a jak nahradit jeho výchozí mechanismus spouštění spolehlivým serverovým cron jobem, když je to nutné.

Projdeme si jak sdílený hosting, tak servery s přístupem k příkazovému řádku.

1. Jak WP-Cron skutečně funguje

Tradiční linuxový cron daemon kontroluje svůj plán nezávisle na provozu webu.

WP-Cron funguje jinak. WordPress kontroluje naplánované úlohy během normální aktivity na webu a v případě potřeby se pokusí spustit požadavek na wp-cron.php.

To znamená, že naplánovaná událost není zaručeno, že se provede v přesně naplánovaném čase.

Představte si web, který obdrží svého posledního návštěvníka v 22:00. Záloha je naplánována na 2:00 ráno, ale nikdo web celou noc nenavštíví.

Záloha se možná nespustí, dokud WordPress neobdrží další požadavek, který spustí jeho plánovací systém.

Jak se liší tyto dvě metody plánování

Výchozí WP-Cron: Požadavek návštěvníka → WordPress kontroluje události → Splněné úlohy se spustí. Závisí na WordPress požadavcích.

Serverový cron: Plánovač serveru → Spustí každých pět minut → Splněné úlohy se spustí. Funguje nezávisle na provozu návštěvníků.

Serverový cron job nemění způsob, jakým WordPress ukládá naplánované události. Jednoduše poskytuje předvídatelnější způsob, jak je kontrolovat a provádět.

2. Rozpoznat příznaky dřív než cokoliv změníte

Ne každá zpožděná WordPress operace je způsobena WP-Cronem.

Začněte identifikací skutečného příznaku.

Příznak Možné vysvětlení
Naplánované příspěvky ukazují "Zmeškáno naplánování" Spouštění cronu zpožděno nebo selhalo
Naplánované e-maily dorazí pozdě Zpoždění cronu, zpracování fronty, nebo problém s doručováním pošty
Automatické zálohy se nespouští Chybějící událost, selhání cronu, nebo chyba pluginu pro zálohy
WooCommerce akce zůvají pending Problém se zpracováním Action Scheduleru
Site Health hlásí chybu loopback requestu WordPress nemůže spolehlivě požádat svou vlastní URL
Úlohy se spustí až po návštěvě webu Spouštění cronu závislé na provozu

Důležitý rozdíl je mezi úlohou, která se nikdy nespustí a úlohou, která se spustí, ale selže.

Nahrazení WP-Cronu serverovým plánovačem může vyřešit první problém. Neopraví automaticky rozbitý plugin, nedostupnou databázi, nebo selhávající e-mailovou službu.

3. Nejdřív zkontrolujte WordPress Site Health

Než se dotknete konfiguračních souborů, otevřete administraci WordPressu.

  1. Jděte na Nástroje → Stav webu.
  2. Otevřete záložku Stav.
  3. Hledejte varování související s naplánovanými událostmi nebo loopback požadavky.
  4. Poznamenejte si přesnou zprávu před provedením změn.

Loopback požadavek je požadavek, který WordPress posílá na svůj vlastní web.

Pokud tyto požadavky selžou, naplánované úlohy nemusí být spouštěny správně.

Běžné příčiny zahrnují nesprávnou URL webu, problémy s DNS překladem, problémy s SSL certifikátem, HTTP autentizaci, omezení firewallu, nebo konflikty s pluginy a tématy.

Příklad: staging web chráněný heslem

Předpokládejme, že jste vytvořili WordPress staging prostředí na:

https://staging.example.com

Staging web vyžaduje HTTP Basic Authentication.

WordPress se pokusí požádat vlastní wp-cron.php endpoint, ale server vrátí HTTP 401, protože požadavek není autentifikován.

Problém není nutně v naplánované úloze samotné. Požadavek, který by úlohu měl spustit, je odmítnut.

V této situaci můžete použít serverový CLI plánovač, který se vyhne veřejné HTTP loopback cestě, nebo nakonfigurovat prostředí tak, aby WordPress interní požadavky fungovaly správně.

Neodstraňujte heslovou ochranu ze staging webu jen proto, aby cron fungoval.

4. Prozkoumejte naplánované úlohy s WP-CLI

Pokud máte SSH přístup a nainstalovaný WP-CLI, můžete prozkoumat plánovač přímo.

Nejprve přejděte do adresáře vaší WordPress instalace.

cd /path/to/wordpress

Pak vypište naplánované události:

wp cron event list

Uvidíte informace jako název hooku, příští naplánované spuštění a opakování.

Pro strojově čitelný výstup:

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

Na co se dívat?

Zaměřte se na události, jejichž příští čas spuštění je v minulosti.

Zpožděná událost je užitečné varovné signál, ale jedna zpožděná událost sama o sobě nedokazuje, že celý plánovač je rozbitý.

Zkontrolujte, zda více nesouvisejících hooků je zpožděných. Pokud ano, prozkoumejte globální mechanismus spouštění.

Illustration of the article's main concept

Pokud jsou ovlivněny události pouze jednoho pluginu, prozkoumejte ten plugin nejprve.

Spusťte splněné úlohy ručně

Na staging prostředí, nebo po potvrzení důsledků na produkci, spusťte:

wp cron event run --due-now

Toto požádá WordPress, aby provedl události, které jsou aktuálně splněné.

Buďte opatrní: tento příkaz provádí skutečnou práci. Může publikovat naplánovaný obsah, poslat zprávy, iniciovat zálohy, nebo spustit e-commerce operace.

Není to bezpečná diagnostická náhledová ukázka.

Pokud dokončí úspěšně, ale úlohy se později znovu stanou zpožděnými, váš problém může být v automatickém mechanismu spouštění spíše než v callback funkcích úloh.

5. Nahraďte závislý-na-provozu WP-Cron serverovým cron jobem

Pro produkční web, kde na naplánovaných úlohách záleží, je serverový cron job často lepší volbou.

Cíl je přímočarý:

  • Zastavit WordPress v pokusech automaticky spouštět WP-Cron při běžných požadavcích na stránky.
  • Požádat server, aby zpracovával splněné události v pravidelných intervalech.

Krok 1: upravte wp-config.php

Vytvořte zálohu wp-config.php.

Přidejte tuto konfiguraci před řádek, který vám říká, abyste přestali editovat:

define('DISABLE_WP_CRON', true);

Toto zakáže výchozí automatické spouštění cronu WordPressem. Nesmaže naplánované události uložené WordPressem.

Krok 2: vytvořte naplánovanou úlohu na vašem hostovacím serveru

Otevřete ovládací panel hostingu a najděte jeho plánovač cron jobů.

Pro standardní WordPress instalaci můžete naplánovat PHP CLI příkaz podobný tomuto:

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

Nahraďte cestu k PHP spustitelnému souboru i cestu k WordPress instalaci skutečnými hodnotami poskytnutými vaším hostitelem.

Příkaz musí používat správnou PHP verzi a mít oprávnění číst WordPress soubory.

Pokud je nainstalovaný WP-CLI, další možností je:

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

Tato alternativa explicitně zpracovává splněné WordPress události přes WP-CLI.

Použijte jeden plánovací metodu pro danou instalaci spíše než konfiguraci několika nezávislých cron jobů, které dělají to samé.

Krok 3: zvolte vhodný interval

Pro typický web je pět minut rozumným výchozím bodem.

Interval spuštění Vyvolání plánovače za den Maximální prodleva dotazování* Příklad crontab výrazu
1 minuta 1,440 1 minuta * * * * *
5 minut 288 5 minut */5 * * * *
10 minut 144 10 minut */10 * * * *
15 minut 96 15 minut */15 * * * *
30 minut 48 30 minut */30 * * * *

*Předpokládá funkční plánovač a krátce běžící úlohy. Skutečné spuštění může být zpožděno zátěží serveru nebo dlouho běžícími callbacky.

Například každých pět minut:

*/5 * * * *

Jednominutový interval nabízí častější kontroly, ale není nutný pro každý web.

Pro blog s nízkým provozem může být pět nebo deset minut zcela dostačující. Pro zatížený e-commerce obchod možná budete potřebovat častější zpracování v závislosti na jeho zátěži na pozadí.

Krok 4: otestujte výsledek

Po konfiguraci serverové úlohy počkejte alespoň dva naplánované intervaly.

Pak znovu prozkoumejte seznam událostí:

wp cron event list

Potvrďte, že dříve zpožděné události byly zpracovány.

Zkontrolujte také cron logy hostingu.

Měli byste také ověřit reálnou obchodní operaci: naplánovaný testovací příspěvek, bezpečnou údržbovou úlohu, nebo jinou operaci, jejíž výsledek lze bezpečně pozorovat.

6. Co když váš hostitel neposkytuje SSH přístup?

Můžete stále nakonfigurovat serverový cron job na mnoha sdílených hostingových plánech.

Některé hostingové panely podporují naplánovaný URL požadavek, například:

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

Jiné nabízejí PHP příkazové provedení bez poskytnutí interaktivního SSH terminálu.

Preferujte PHP CLI úlohu, když je podporována. Naplánovaný HTTP požadavek může být ovlivněn přesměrováními, přístupovými omezeními, bezpečnostními pravidly, nebo síťovými problémy.

Pokud váš hostingový panel podporuje pouze HTTP požadavky, potvrďte, že endpoint je dostupný a že požadavek skutečně spouští splněné úlohy.

Nepředpokládejte, že přijetí HTTP 200 odpovědi dokazuje, že každý naplánovaný callback dokončil úspěšně.

Technical workflow illustration

7. Vytvořte bezpečnou testovací událost

Pro vývojáře může malý testovací plugin pomoci potvrdit, že plánovací systém funguje nezávisle na existujících pluginech.

Vytvořte tento soubor:

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

Přidejte:

<?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');
});

Aktivujte plugin z administrace WordPressu.

Registruje hodinovou událost, která zapisuje jednoduchou diagnostickou zprávu do PHP error logu. Neposílá e-maily, nemění obsah, nedělá externí síťové požadavky.

První událost je naplánována přibližně minutu po aktivaci.

Pro okamžité testování po aktivaci s WP-CLI:

wp cron event run ceikay_cron_test

Zkontrolujte PHP error log pro zprávu podobnou:

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

Časová razítka je pouze příklad.

Pokud dáváte přednost testování automatického plánovače spíše než ručního spouštění hooku, počkejte, až událost se stane splněnou, a nechte nakonfigurovaný cron mechanismus ji zpracovat.

Po dokončení testování deaktivujte a smažte diagnostický plugin.

8. Řešení problémů: cron job běží, ale úlohy stále selžou

Fungující cron spouštěcí mechanismus je jen jedna část systému.

Pokud váš serverový plánovač běží úspěšně, ale WordPress operace nadále selžou, použijte následující diagnostickou tabulku.

Problém Co zkontrolovat Navrhovaná akce
Žádné naplánované události nejsou uvedeny Plugin nemusel zaregistrovat svůj hook Zkontrolujte aktivaci pluginu a plánovací kód
Události zůstávají zpožděné Serverová úloha nemusí být prováděna Zkontrolujte cron logy, PHP cestu a oprávnění
PHP fatální chyba Selhání task callbacku nebo pluginu Prozkoumejte PHP error logy a stack trace
HTTP 401 nebo 403 Autentizace nebo firewall Zkontrolujte omezení loopback přístupu
HTTP 500 Selhání aplikace nebo serveru Prozkoumejte PHP/server logy
Události se provádějí, ale e-maily nedocházejí Problém s mail transportem Zkontrolujte SMTP nebo logy doručování e-mailů
Duplicitní provedení Duplicitní plány nebo překrývající se procesy Prozkoumejte hooky, argumenty a zamykání
WooCommerce akce zůvají pending Zátěž Action Scheduleru Prozkoumejte rozhraní naplánovaných akcí a jednotlivé selhání

Nesmažte slepo zpožděné události

Může být lákavé odstranit každou událost, která vypadá jako zaseknutá.

Vyhněte se tomu.

Událost může představovat legitimní naplánovanou platební operaci, zpracování objednávky, doručení e-mailu, nebo zálohu.

Smazání události může odstranit naplánovanou práci bez opravy underlying problému.

WP-CLI poskytuje příkazy pro mazání událostí, ale tyto by měly být použity až po identifikaci hooku a porozumění jeho účelu.

9. Vyhněte se duplicitním naplánovaným událostem ve svých pluginech

Pokud vyvíjíte WordPress plugin, častou chybou je opakované registrování stejné opakované události.

Například plánování úlohy při každém načtení stránky bez kontroly, zda již existuje.

Správný přístup je nejprve zkontrolovat:

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

Pak zaregistrovat callback samostatně:

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

Pokud událost přijímá argumenty, používejte konzistentní argumenty při plánování, kontrole a mazání. WordPress používá hook a argumenty k rozlišení naplánovaných událostí.

Také zvažte dobu provedení. Úloha, která zpracovává tisíce záznamů v jednom požadavku, může vyčerpat PHP čas provedení nebo paměť.

Pro velké zátěže zpracovávejte data v malých dávkách, dělejte operace bezpečné pro opakování a evidujte pokrok.

10. Praktický checklist pro spolehlivý WordPress plánovač

Než budete problém považovat za vyřešený, ověřte tyto body:

  • [ ] WordPress Site Health neukazuje neobjasněné chyby plánování nebo loopbacku.
  • [ ] Očekávané naplánované hooky existují.
  • [ ] Server cron se provádí v zamýšleném intervalu.
  • [ ] DISABLE_WP_CRON je nakonfigurován až po připravení alternativního triggeru.
  • [ ] Cron job používá správnou PHP spustitelnou cestu a WordPress cestu.
  • [ ] Reálná naplánovaná úloha dokončila úspěšně.
  • [ ] Logy lze konzultovat, když úloha selže.
  • [ ] Žádná duplicitní konfigurace plánovače není aktivní.
  • [ ] Kritické operace mají své vlastní monitorování nebo varovné alerty.

Spolehlivý plánovač není jen ten, co běží. Je to ten, jehož selhání můžete identifikovat a prozkoumat.

11. Závěrečné myšlenky: kdy byste měli použít serverový cron?

Pro malý osobní blog s občasnými návštěvníky a bez časově citlivé automatizace může výchozí WP-Cron být zcela dostačující.

Ale pokud váš web spoléhá na naplánované publikování, údržbu na pozadí, e-commerce zpracování, nebo jiné opakované operace, serverový cron job je hodný zvážení.

Vylepšení není v tom, že serverový cron magicky učiní každý WordPress plugin spolehlivým. Odstraní jeden důležitý zdroj nejistoty: závislost na příchozích webových požadavcích pro spouštění splněných událostí.

Začněte diagnostikou skutečného selhání, prozkoumejte naplánované události, a teprve pak měňte spouštěcí mechanismus.

Tento přístup je bezpečnější než instalace dalšího pluginu nebo úprava konfiguračních nastavení bez vědomí, co se pokazilo.