همه مقالات تخصصی

رفع مشکل WP-Cron وردپرس و جایگزینی آن با Cron واقعی سرور

آموزش تشخیص رویدادهای زمان‌بندی‌شده وردپرس و اجرای پایدار WP-Cron با cron واقعی لینوکس.

رفع مشکل WP-Cron وردپرس و جایگزینی آن با Cron واقعی سرور

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