Web și dezvoltare

Cronul WordPress nu funcționează? Cum să repari sarcinile programate și postările pierdute

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

Postările programate WordPress nu se publică? Învață cum să diagnostichezi problemele WP-Cron, să inspectezi evenimentele programate, să repari erorile de loopback și să configurezi pas cu pas un job cron de server fiabil.

WordPress Cron nu funcționează? Cum să remediați sarcinile programate și articolele ratate

Programați un articol WordPress pentru ora 9:00. La 9:30, acesta încă nu a apărut.

Sau poate e-mailurile WooCommerce ajung cu întârziere, backup-urile programate nu pornesc niciodată, ori un plugin raportează că sarcinile sale din fundal sunt restante.

Aceste probleme au adesea ceva în comun: WP-Cron, sistemul încorporat de programare a sarcinilor din WordPress.

WP-Cron este convenabil deoarece funcționează fără a necesita acces la planificatorul de sarcini al serverului de găzduire. Însă, spre deosebire de un job cron tradițional de sistem, nu rulează continuu în fundal.

În acest ghid, veți afla cum funcționează WP-Cron, cum să identificați cauza sarcinilor întârziate și cum să înlocuiți mecanismul său implicit de declanșare cu un job cron de server fiabil atunci când este necesar.

Vom acoperi atât găzduirea partajată, cât și serverele cu acces la linia de comandă.

1. Cum funcționează de fapt WP-Cron

Un daemon cron Linux tradițional își verifică programul independent de traficul site-ului.

WP-Cron funcționează diferit. WordPress verifică sarcinile programate în timpul activității normale a site-ului și, când este cazul, încearcă să lanseze o cerere către wp-cron.php.

Asta înseamnă că un eveniment programat nu are garantat executarea la ora exactă programată.

Imaginați-vă un site care primește ultimul vizitator la 22:00. Un backup este programat pentru 02:00, dar nimeni nu vizitează site-ul peste noapte.

Backup-ul poate să nu înceapă până când WordPress nu primește o altă cerere care îi declanșează sistemul de programare.

Cum diferă cele două metode de programare

WP-Cron implicit: Cerere de la vizitator → WordPress verifică evenimentele → Sarcinile scadente pornesc. Depinde de cererile către WordPress.

Cron de server: Planificatorul serverului → Rulează la fiecare cinci minute → Sarcinile scadente pornesc. Funcționează independent de traficul vizitatorilor.

Un job cron de server nu schimbă modul în care WordPress stochează evenimentele programate. Oferă pur și simplu o modalitate mai previzibilă de a le verifica și executa.

2. Recunoașteți simptomele înainte de a schimba ceva

Nu orice operațiune întârziată din WordPress este cauzată de WP-Cron.

Începeți prin a identifica simptomul real.

Simptom Posibilă explicație
Articolele programate afișează „Programare ratată” Declanșarea cron a fost întârziată sau a eșuat
E-mailurile programate ajung cu întârziere Întârziere cron, procesare a cozii sau problemă de livrare a e-mailurilor
Backup-urile automate nu pornesc niciodată Eveniment lipsă, eșec cron sau eroare a pluginului de backup
Acțiunile WooCommerce rămân în așteptare Problemă de procesare a Action Scheduler
Site Health raportează o eroare de loopback WordPress nu poate solicita în mod fiabil propriul URL
Sarcinile rulează doar după vizitarea site-ului Declanșare cron dependentă de trafic

Distincția importantă este între o sarcină care nu pornește niciodată și o sarcină care pornește, dar eșuează.

Înlocuirea WP-Cron cu un planificator de server poate rezolva prima problemă. Nu va repara automat un plugin defect, o bază de date indisponibilă sau un serviciu de e-mail care eșuează.

3. Verificați mai întâi WordPress Site Health

Înainte de a modifica fișierele de configurare, deschideți interfața de administrare WordPress.

  1. Accesați Unelte → Stare site.
  2. Deschideți fila Status.
  3. Căutați avertismente legate de evenimente programate sau cereri de loopback.
  4. Notați mesajul exact înainte de a face modificări.

O cerere de loopback este o cerere pe care WordPress o face către propriul site.

Dacă aceste cereri eșuează, sarcinile programate pot să nu fie declanșate corect.

Cauzele frecvente includ un URL incorect al site-ului, probleme de rezolvare DNS, probleme cu certificatul SSL, autentificare HTTP, restricții de firewall sau conflicte cu pluginuri și teme.

Exemplu: un site de staging protejat cu parolă

Să presupunem că ați creat un mediu WordPress de staging la:

https://staging.example.com

Site-ul de staging necesită autentificare HTTP Basic.

WordPress încearcă să solicite propriul endpoint wp-cron.php, dar serverul returnează HTTP 401 deoarece cererea nu este autentificată.

Problema nu este neapărat sarcina programată în sine. Cererea care ar trebui să declanșeze sarcina este respinsă.

În această situație, puteți utiliza un planificator CLI pe partea de server, care evită ruta publică de loopback HTTP, sau puteți configura mediul astfel încât cererile interne ale WordPress să funcționeze corect.

Nu eliminați protecția prin parolă de pe un site de staging doar pentru a face cronul să funcționeze.

4. Inspectați sarcinile programate cu WP-CLI

Dacă aveți acces SSH și WP-CLI instalat, puteți inspecta direct planificatorul.

Mai întâi, deplasați-vă în directorul de instalare WordPress.

cd /path/to/wordpress

Apoi listați evenimentele programate:

wp cron event list

Veți vedea informații precum numele hook-ului, următoarea execuție programată și recurența.

Pentru o ieșire citibilă de mașină:

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

La ce ar trebui să fiți atenți?

Fiți atenți la evenimentele a căror următoare oră de execuție este în trecut.

Un eveniment restant este un semn de avertizare util, dar un singur eveniment restant nu dovedește că întregul planificator este defect.

Verificați dacă mai multe hook-uri fără legătură sunt restante. Dacă da, investigați mecanismul global de declanșare.

Illustration of the article's main concept

Dacă sunt afectate doar evenimentele unui singur plugin, inspectați mai întâi acel plugin.

Rulați manual sarcinile scadente

Pe un mediu de staging sau după ce ați confirmat consecințele în producție, rulați:

wp cron event run --due-now

Aceasta cere WordPress să execute evenimentele care sunt scadente în prezent.

Fiți atenți: această comandă efectuează operațiuni reale. Poate publica conținut programat, trimite mesaje, iniția backup-uri sau declanșa operațiuni de comerț electronic.

Nu este o previzualizare diagnostică inofensivă.

Dacă se finalizează cu succes, dar sarcinile devin din nou restante mai târziu, problema poate fi mecanismul automat de declanșare, nu callback-urile sarcinilor.

5. Înlocuiți WP-Cron dependent de trafic cu un job cron de server

Pentru un site de producție în care sarcinile programate contează, un job cron de server este adesea o alegere mai bună.

Obiectivul este simplu:

  • Opriți WordPress din a încerca să genereze automat WP-Cron la cererile normale pentru pagini.
  • Cereți serverului să proceseze evenimentele scadente la intervale regulate.

Pasul 1: editați wp-config.php

Faceți o copie de rezervă a wp-config.php.

Adăugați această configurație înainte de linia care vă spune să opriți editarea:

define('DISABLE_WP_CRON', true);

Aceasta dezactivează generarea automată implicită a cronului în WordPress. Nu șterge evenimentele programate stocate de WordPress.

Pasul 2: creați o sarcină programată pe serverul de găzduire

Deschideți panoul de control al găzduirii și găsiți planificatorul de joburi cron.

Pentru o instalare WordPress standard, puteți programa o comandă PHP CLI similară cu:

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

Înlocuiți atât calea executabilului PHP, cât și calea instalării WordPress cu valorile reale furnizate de gazda dvs.

Comanda trebuie să ruleze versiunea corectă de PHP și să aibă permisiunea de a citi fișierele WordPress.

Dacă WP-CLI este instalat, o altă opțiune este:

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

Această alternativă procesează explicit evenimentele WordPress scadente prin WP-CLI.

Folosiți o singură metodă de programare pentru o instalare dată, în loc să configurați mai multe joburi cron independente care fac același lucru.

Pasul 3: alegeți un interval adecvat

Pentru un site obișnuit, cinci minute reprezintă un punct de plecare rezonabil.

Interval de execuție Invocări ale planificatorului pe zi Întârziere maximă de verificare* Exemplu de expresie crontab
1 minut 1.440 1 minut * * * * *
5 minute 288 5 minute */5 * * * *
10 minute 144 10 minute */10 * * * *
15 minute 96 15 minute */15 * * * *
30 minute 48 30 minute */30 * * * *

*Presupune un planificator funcțional și sarcini de scurtă durată. Execuția reală poate fi întârziată de încărcarea serverului sau de callback-uri de lungă durată.

De exemplu, la fiecare cinci minute:

*/5 * * * *

Un interval de un minut oferă verificări mai frecvente, dar nu este necesar pentru fiecare site.

Pentru un blog cu trafic redus, cinci sau zece minute pot fi complet suficiente. Pentru un magazin de comerț electronic aglomerat, este posibil să aveți nevoie de procesare mai frecventă, în funcție de volumul de lucru din fundal.

Pasul 4: testați rezultatul

După configurarea jobului de server, așteptați cel puțin două intervale programate.

Apoi inspectați din nou lista evenimentelor:

wp cron event list

Confirmați că evenimentele anterior restante au fost procesate.

Verificați și jurnalele cron ale găzduirii.

Ar trebui să verificați și o operațiune reală de business: un articol de test programat, o sarcină de întreținere inofensivă sau altă operațiune al cărei rezultat poate fi observat în siguranță.

6. Ce faceți dacă gazda dvs. nu oferă acces SSH?

Puteți configura totuși un job cron de server pe multe planuri de găzduire partajată.

Unele panouri de găzduire acceptă o cerere URL programată, de exemplu:

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

Altele oferă execuția comenzilor PHP fără a furniza un terminal SSH interactiv.

Preferați o sarcină PHP CLI atunci când este acceptată. O cerere HTTP programată poate fi afectată de redirecționări, restricții de acces, reguli de securitate sau probleme de rețea.

Dacă panoul de găzduire acceptă doar cereri HTTP, confirmați că endpointul este accesibil și că cererea declanșează efectiv sarcinile scadente.

Nu presupuneți că primirea unui răspuns HTTP 200 dovedește că fiecare callback programat s-a finalizat cu succes.

Technical workflow illustration

7. Creați un eveniment de test sigur

Pentru dezvoltatori, un mic plugin de test poate ajuta la confirmarea faptului că sistemul de programare funcționează independent de pluginurile existente.

Creați acest fișier:

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

Adăugați:

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

Activați pluginul din interfața de administrare WordPress.

Acesta înregistrează un eveniment orar care scrie un mesaj de diagnostic simplu în jurnalul de erori PHP. Nu trimite e-mailuri, nu modifică conținut și nu face cereri de rețea externe.

Primul eveniment este programat la aproximativ un minut după activare.

Pentru a-l testa imediat după activare cu WP-CLI:

wp cron event run ceikay_cron_test

Verificați jurnalul de erori PHP pentru un mesaj similar cu:

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

Marcajul temporal este doar un exemplu.

Dacă preferați să testați planificatorul automat în loc să executați manual hook-ul, așteptați ca evenimentul să devină scadent și lăsați mecanismul cron configurat să îl proceseze.

Când testarea este completă, dezactivați și ștergeți pluginul de diagnostic.

8. Depanare: jobul cron rulează, dar sarcinile tot eșuează

Un declanșator cron funcțional este doar o parte a sistemului.

Dacă planificatorul serverului rulează cu succes, dar operațiunile WordPress continuă să eșueze, utilizați următorul tabel de diagnostic.

Problemă Ce trebuie verificat Acțiune sugerată
Nu sunt listate evenimente programate Este posibil ca pluginul să nu își fi înregistrat hook-ul Verificați activarea pluginului și codul de programare
Evenimentele rămân restante Este posibil ca jobul de server să nu se execute Verificați jurnalele cron, calea PHP și permisiunile
Eroare fatală PHP Eșec al callback-ului sarcinii sau al pluginului Inspectați jurnalele de erori PHP și stack trace-ul
HTTP 401 sau 403 Autentificare sau firewall Revizuiți restricțiile de acces pentru loopback
HTTP 500 Eșec al aplicației sau al serverului Inspectați jurnalele PHP/serverului
Evenimentele se execută, dar e-mailurile nu ajung Problemă de transport al e-mailurilor Verificați jurnalele SMTP sau de livrare a e-mailurilor
Execuții duplicate Programări duplicate sau procese suprapuse Inspectați hook-urile, argumentele și blocarea
Acțiunile WooCommerce rămân în așteptare Restanță în Action Scheduler Inspectați interfața acțiunilor programate și eșecurile individuale

Nu ștergeți orbește evenimentele restante

Poate fi tentant să eliminați fiecare eveniment care pare blocat.

Evitați să faceți asta.

Un eveniment poate reprezenta o operațiune legitimă programată legată de plăți, o sarcină de procesare a comenzilor, o livrare de e-mail sau un backup.

Ștergerea evenimentului poate elimina lucrarea programată fără a rezolva problema de fond.

WP-CLI oferă comenzi pentru ștergerea evenimentelor, dar acestea ar trebui utilizate numai după identificarea hook-ului și înțelegerea scopului său.

9. Evitați evenimentele programate duplicate în propriile pluginuri

Dacă dezvoltați un plugin WordPress, o greșeală frecventă este înregistrarea repetată a aceluiași eveniment recurent.

De exemplu, programarea unei sarcini la fiecare încărcare de pagină fără a verifica dacă aceasta există deja.

Abordarea corectă este să verificați mai întâi:

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

Apoi înregistrați callback-ul separat:

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

Dacă evenimentul acceptă argumente, utilizați argumente consecvente atunci când îl programați, îl verificați și îl eliminați. WordPress folosește hook-ul și argumentele pentru a distinge evenimentele programate.

Luați în considerare și durata de execuție. O sarcină care procesează mii de înregistrări într-o singură cerere poate epuiza timpul de execuție PHP sau memoria.

Pentru volume mari de lucru, procesați datele în loturi mici, faceți operațiunile sigure pentru reîncercare și înregistrați progresul.

10. O listă de verificare practică pentru un planificator WordPress fiabil

Înainte de a considera problema rezolvată, verificați aceste puncte:

  • [ ] WordPress Site Health nu afișează erori inexplicabile de programare sau loopback.
  • [ ] Hook-urile programate așteptate există.
  • [ ] Cronul de server se execută la intervalul dorit.
  • [ ] DISABLE_WP_CRON este configurat numai după ce un declanșator alternativ este pregătit.
  • [ ] Jobul cron folosește executabilul PHP corect și calea WordPress corectă.
  • [ ] O sarcină programată reală se finalizează cu succes.
  • [ ] Jurnalele pot fi consultate atunci când o sarcină eșuează.
  • [ ] Nu este activă nicio configurație duplicată a planificatorului.
  • [ ] Operațiunile critice au monitorizare proprie sau alerte de eșec.

Un planificator fiabil nu este doar unul care rulează. Este unul ale cărui eșecuri le puteți identifica și investiga.

11. Considerații finale: când ar trebui să utilizați cronul de server?

Pentru un blog personal mic, cu vizitatori ocazionali și fără automatizări sensibile la timp, WP-Cron implicit poate fi perfect adecvat.

Dar dacă site-ul dvs. se bazează pe publicare programată, întreținere în fundal, procesare de comerț electronic sau alte operațiuni recurente, merită luat în considerare un job cron de server.

Îmbunătățirea nu constă în faptul că cronul de server face magic fiecare plugin WordPress fiabil. Elimină o sursă importantă de incertitudine: dependența de cererile primite către site pentru a declanșa evenimentele scadente.

Începeți prin a diagnostica eșecul real, inspectați evenimentele programate și abia apoi schimbați mecanismul de declanșare.

Această abordare este mai sigură decât instalarea altui plugin sau modificarea setărilor de configurare fără a ști ce a mers greșit.