WP-Cron زمانبند واقعی نیست؛ با درخواست بازدیدکننده اجرا میشود. در سایت کمترافیک اجرای کارها عقب میافتد و در سایت پرترافیک فراخوانیهای همزمان میتواند بار اضافی بسازد.
اول صف را بررسی کنید
wp cron event list --fields=hook,next_run,recurrence
wp cron test
wp cron event run --due-now
پیش از تغییر، خطای PHP، loopback request و افزونهای که hook را ساخته بررسی کنید. اجرای دستی موفق ولی اجرای خودکار ناموفق معمولاً مشکل trigger است.
غیرفعالکردن pseudo-cron
در wp-config.php اضافه کنید:
define('DISABLE_WP_CRON', true);
سپس cron سیستم را با کاربر صحیح وبسایت هر پنج دقیقه اجرا کنید:
*/5 * * * * cd /var/www/example && /usr/local/bin/wp cron event run --due-now --quiet
مسیر WordPress، PHP/WP-CLI و کاربر اجرا باید دقیق باشد. در محیط چندسایتی فرمان را برای هر سایت یا با راهکار مناسب شبکه تنظیم کنید.
امنیت و پایش
از اجرای cron با root خودداری کنید. خروجی خطا را به لاگ محدود منتقل و موفقیت را پایش کنید. قفل همزمانی بگذارید تا job قبلی و بعدی روی هم نیفتند.
flock -n /tmp/wp-cron.lock wp cron event run --due-now --quiet
در پایان یک نوشته آزمایشی زمانبندی کنید، زمان انتشار و صف cron را بررسی کنید و هشدار برای رویدادهای overdue بسازید.
پاسخ کوتاه
WP-Cron فقط هنگام دریافت درخواست وب اجرا میشود؛ بنابراین در سایت کمترافیک یا پشت Page Cache ممکن است Jobها دیر اجرا شوند. راهحل پایدار، غیرفعالکردن اجرای خودکار داخلی و فراخوانی wp-cron.php با Cron واقعی سرور است؛ اما قبل از تغییر باید Eventهای عقبافتاده، قفل Cron و سلامت اجرای دستی بررسی شوند.
علائم رایج
- انتشار زمانبندیشده یا ایمیلها با تأخیر اجرا میشوند.
- در Site Health پیام missed schedule دیده میشود.
- Transient مربوط به doing_cron مدت طولانی باقی مانده است.
علتهای محتمل
- ترافیک کم یا Cache کامل صفحه
- Loopback مسدودشده توسط Firewall یا Basic Auth
- Job سنگین یا افزونهای که Exception تولید میکند
دستورات تشخیصی و خروجی نمونه
wp cron event list --fields=hook,next_run,next_run_relative --format=table
wp cron test
wp cron event run --due-now
curl -fsS https://example.com/wp-cron.php?doing_wp_cron >/dev/null
Sample:
Success: WP-Cron spawning is working as expected.
Executed the cron event successfully.
چطور مطمئن شویم مشکل حل شده؟
پس از اجرای دستی، next_run باید جلو برود و صف Eventهای due کاهش یابد. لاگ PHP و افزونه ایمیل را نیز بررسی کنید و حداقل دو چرخه زمانبندی را بدون خطا ببینید.
خطرات و Rollback
قبل از افزودن DISABLE_WP_CRON از wp-config.php نسخه پشتیبان بگیرید. ابتدا Cron سیستم را فعال و تست کنید، سپس اجرای داخلی را غیرفعال کنید. Rollback با حذف ثابت و Cron سیستم انجام میشود.
سناریوی واقعی
در یک سایت شرکتی کمترافیک، Backup شبانه چند ساعت دیر اجرا میشد. پس از ثبت Baseline، Cron پنجدقیقهای سرور جایگزین شد و طی ۲۴ ساعت هیچ Event عقبافتادهای باقی نماند.
منابع رسمی
آخرین بازبینی: 2026-10-01
