2026.07.01.
Weboldal fejlesztés és SEO

WordPress cron feladatok hibakeresése wp cron problémákkal.

Temesvári László

WordPress cron feladatok: ne dőlj be a látszatnak, tervezz megbízhatóan!

Ha WordPress fejlesztéssel foglalkozol, valószínűleg találkoztál már a wp_cron rendszerrel. Az a furcsa érzés, amikor rájössz, hogy a „cron” a nevében ellentétben a valódi, rendszer-szintű cronnal, csak egy szimuláció. Egy olyan szimuláció, amely kizárólag a látogatók kérésére fut le. Ma szeretném megosztani a tapasztalataimat, hogyan tervezzünk megbízhatóan erre a speciális környezetre, és hogyan kerüljük el a gyakori csapdákat – mintha egy kávé mellett beszélgetnénk a fejlesztői sarokban.

Mi is az a WP Cron valójában?

A WordPress cronja nem egy háttérben pörgő démon. Inkább egy okos, de passzív mechanizmus. Amikor valaki betölt egy oldalt a WordPress oldaladon, a rendszer megnézi: „Van-e olyan ütemezett feladat, aminek már le kellett volna futnia?” Ha igen, akkor a rendszer a látogató kérésének a szálában próbálja végrehajtani. Ez nagyszerű egyszerűség a shared hostingon, de katasztrófális lehet a megbízhatóságra és a teljesítményre nézve, ha nem értjük a limitációit.

A probléma gyökere: ha nincs látogató, nincs cron futás. Ha egy feladat sokáig tart, a felhasználó lapbetöltése is sokáig tart. Ha a feladat elhasal, lehet, hogy észre sem veszed.

Tervezési alapelvek: Készülj fel a legrosszabbra

A kulcs a megbízhatóságban az, hogy a WP Cron-t kiszámítható és rugalmas feladatokra használjuk, és mindig felkészülünk az esetleges bukásra.

1. Legyenek atomiak a feladatok: Egy cron hook ne próbáljon meg 5000 e-mailt kiküldeni. Inkább indítson egy eljárást, amely feldolgoz 50-et, és maga ütemezze be a következő 50 feldolgozását, ha még van. Ez a wp_schedule_single_event() barátod.

    function küldés_köteg_elindítása( $köteg_száma = 0 ) {
        $emailek = get_50_feldolgozatlan_email( $köteg_száma );
        
        if ( ! empty( $emailek ) ) {
            foreach ( $emailek as $email ) {
                wp_mail( $email['cím'], $email['tárgy'], $email['tartalom'] );
                jelöld_feldolgozottnak( $email['id'] );
            }
            // Ütemezd a következő köteget, ha kell
            if ( több_email_van() ) {
                wp_schedule_single_event( time() + 60, 'email_köteg_feldolgozás', array( $köteg_száma + 1 ) );
                // Spórolj egy kérést: spawnolj egy cron-t a háttérben
                spawn_cron();
            }
        }
    }
    add_action( 'email_köteg_feldolgozás', 'küldés_köteg_elindítása', 10, 1 );

2. Használj konzisztens ütemezést: Kerüld a „minden héten” (wp_get_schedule()) definíciókat, ha pontos időpontra van szükséged. Inkább ütemezz „minden nap 23:00-kor” egyedi időpontokkal. A valódi rendszer cron legfőbb feladata pontosan ez legyen: egy GET kérés a wp-cron.php-ra a kívánt időben.

    # Valódi szerver cron bejegyzés (pl. cPanel vagy ssh)
    */15 * * * * wget -q -O - https://oldalad.hu/wp-cron.php?doing_wp_cron >/dev/null 2>&1

*Ez a sor a Holy Grail. 15 percenként meghívja a WP cron-t, függetlenül a látogatóktól.*

Hibakeresés: Ne hagyd sötétben magad

A WP Cron egy fekete doboz, ha nem vagyunk körültekintőek. Íme a debugging tool-készletem:

* WP CLI a király: A legegyszerűbb módja a cron kezelésének. Futtasd lokálisan vagy SSH-n keresztül.

    wp cron list # Összes ütemezett esemény listázása
    wp cron event run <hook_neve> # Egy konkrét hook azonnali futtatása
    wp cron event delete <hook_neve> # Egy elakadt esemény törlése

* Naplózz, naplózz, naplózz! Minden cron callback-ed elején és végén írj a debug.log-ba. Használj egyedi prefixet, hogy könnyen szűrhess.

    function naplózott_cron_feladat() {
        error_log( '=== CRON START: adat_szinkronizálás ===' );
        // ... a feladat logikája ...
        if ( $hiba ) {
            error_log( 'CRON HIBÁVAL VÉGZŐDÖTT: ' . $hiba->getMessage() );
        }
        error_log( '=== CRON END: adat_szinkronizálás ===' );
    }

* Nézd meg a frontendet is: Egy elakadt, hosszú futású cron megjelenhet a felhasználók számára is. Egy egyszerű jQuery indikátor segíthet, ha tudod, hogy épp futhat egy háttérfeladat.

    // Példa: Ha egy hosszú cron fut, mutass egy diszkrét indikátort az admin felületen.
    jQuery(document).ready(function($) {
        // Tegyük fel, hogy a WP egy osztállyal jelzi a hosszú feldolgozást
        if ($('body').hasClass('admin-cron-running')) {
            $('<div class="alert alert-info alert-dismissible fade show fixed-top" role="alert" style="z-index: 9999;">Háttérfeladat feldolgozás alatt...<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button></div>').prependTo('body');
        }
    });

*(A Bootstrap alert komponensét használjuk a stílus és az animáció érdekében, természetesen a saját CSS/SCSS-eddel is megoldhatod.)*

* Advanced Cron Manager plugin: Ha grafikus felületre vágysz, ez a plugin elképesztő betekintést ad az összes ütemezett feladatba, azok paramétereibe, és lehetővé teszi manuális futtatásukat, törlésüket.

Gyakori buktatók, amikbe én is belefutottam

1. A túl hosszú timeout: A PHP max_execution_time lecsaphat egy hosszabb feldolgozást. Használj kötegezést és set_time_limit(0)-t körültekintően. 2. Az eltűnt hook: Ha a pluginodat deaktiválod, a hozzá tartozó ütemezett cron események továbbra is az ütemezésben maradnak, de mivel a callback függvény nem létezik, csendben meghalnak. Töröld őket deaktiváláskor. 3. A memóriaéhség: A cron futtatása ugyanazt a memórialimitet (wp_memory_limit) használja, mint a frontend. Intézkedj, ha nagy feldolgozásod van. 4. A pontos időzítés hiánya: wp_schedule_event() nem garantálja a pontos percnyi futtatást. Ha a cron a látogatóra vár, akár több óra késés is lehet. A megoldás: a már említett szerver cron.

Összegzés: A kétpillerű megközelítés

A legjobb gyakorlat, amire rájöttem, a hibrid megközelítés:

1. Használd a WP Cron API-t a feladatok definiálásához, kezeléséhez, mert kényelmes és WordPress-es. (A wp_schedule_event(), wp_next_scheduled() funkciók barátaid.) 2. De kapcsold ki a WP Cron szimulációját, és támaszkodj a valódi szerver cronra a triggerelésért. Tedd ezt a wp-config.php-ba:

    define('DISABLE_WP_CRON', true);

Így a feladatlogikád a WordPress kényelmében él, de a futtatás időzítése kiszámítható és megbízható lesz. Ne feledd: a WP Cron nem rossz, csak nem azt csinálja, amit a neve sugall. Ismerd meg a limitációit, tervezz azok szerint, és sosem fog meglepetésként érni egy elmaradt adatexport vagy e-mail kampány.

Próbáld ki ezeket a gyakorlatokat a következő projekteden – és nyugodtan írd meg a kommentekben, hogy neked mi vált be a cron hibakeresésében!

Kapcsolódó cikkek