کرون جاب WHMCS وظیفه اجرای خودکار فرایندهای زمانبندیشده در سیستم WHMCS را بر عهده دارد. این قابلیت به WHMCS کمک میکند کارهایی مانند صدور صورتحسابهای دورهای، بررسی سررسید فاکتورها، ارسال یادآوری پرداخت و مدیریت فرایندهای مرتبط با تمدید دامنه را طبق برنامه انجام دهد.
برای عملکرد صحیح این سیستم، باید کرون جاب WHMCS بهدرستی تنظیم شده باشد و در فاصلههای زمانی مشخص اجرا شود. اگر این دستور اجرا نشود یا با خطا مواجه شود، ممکن است صدور فاکتورها، ارسال اعلانها و برخی عملیات خودکار مربوط به سرویسها و دامنهها با تأخیر انجام شوند.
در این راهنما از روناک هاست، با نحوه عملکرد کرون جاب WHMCS، دستور اجرای آن، فاصله زمانی مناسب و روش بررسی خطاها آشنا میشوید. تمرکز مقاله بر وظایف خودکار مربوط به صورتحساب و دامنه است و تنظیمات عمومی کرون لینوکس یا سیپنل را دوباره توضیح نمیدهیم.
فهرست مطالب
Toggleکرون جاب WHMCS چه وظایفی را انجام میدهد؟
کرون WHMCS فرایندهای خودکار این نرم افزار را اجرا میکند تا مدیر هاستینگ مجبور نباشد تمام کارهای مربوط به صورتحساب، تمدید سرویس و دامنه را بهصورت دستی انجام دهد. در نصبهای مستقل (Self-Hosted)، این فرایند از طریق اجرای اسکریپت cron.php انجام میشود.
مهمترین وظایف کرون جاب WHMCS در بخش صورتحساب و دامنه عبارتاند از:
- صدور خودکار صورتحساب: بررسی تاریخ سررسید سرویسها، افزونهها و دامنهها و ایجاد فاکتور تمدید در بازه زمانی تعیینشده.
- ارسال یادآوری پرداخت: ارسال ایمیل یادآوری برای فاکتورهای نزدیک به سررسید یا پرداختنشده، مطابق تنظیمات سیستم.
- مدیریت فاکتورهای معوق: اعمال جریمه دیرکرد یا لغو خودکار فاکتورهای پرداختنشده، در صورت فعال بودن تنظیمات مربوطه.
- بررسی وضعیت دامنهها: همگامسازی تاریخ انقضا، تاریخ سررسید و وضعیت دامنهها با اطلاعات دریافتی از ماژول ثبتکننده دامنه.
- ارسال اعلان تمدید دامنه: ارسال اطلاعیههای مربوط به نزدیک شدن تاریخ تمدید دامنه به مشتریان.
فرض کنید مشتری یک سرویس میزبانی با دوره پرداخت سالانه و یک دامنه با تاریخ تمدید مشخص دارد. WHMCS با اجرای کرون جاب، تاریخهای سررسید را بررسی میکند و در صورت رسیدن به بازه صدور صورتحساب، فاکتور مربوط به سرویس یا دامنه را ایجاد میکند. سپس بر اساس تنظیمات یادآوری، ایمیلهای لازم را برای مشتری میفرستد.
نکته مهم این است که اجرای کرون بهتنهایی به معنی تمدید قطعی دامنه نیست. کرون وظایف زمانبندیشده و صدور صورتحساب را انجام میدهد؛ ثبت یا تمدید دامنه نیز به پرداخت مشتری، تنظیمات تمدید خودکار و عملکرد ماژول ثبتکننده دامنه وابسته است.
نحوه تنظیم دستور کرون جاب WHMCS و فاصله اجرای آن
دستور کرون جاب WHMCS شامل زمانبندی اجرای دستور، مسیر فایل cron.php و مفسر PHP است. این دستور باید بهگونهای تنظیم شود که اسکریپت اصلی کرون در بازههای زمانی مشخص اجرا شود و وظایف خودکار WHMCS را بررسی کند.
دستور اجرای کرون جاب WHMCS چیست؟
برای اجرای کرون جاب WHMCS از اسکریپت cron.php استفاده میشود. نمونه دستور پیشنهادی WHMCS برای اجرای این اسکریپت هر پنج دقیقه یکبار به شکل زیر است:
*/5 * * * * php -q /home/username/crons/cron.php
اجزای این دستور عبارتاند از:
| بخش دستور | کاربرد |
| */5 * * * * | اجرای دستور در فاصلههای پنجدقیقهای |
| php | اجرای فایل با مفسر PHP |
| -q | اجرای PHP در حالت Quiet برای کاهش خروجیهای غیرضروری |
| /home/username/crons/cron.php | مسیر فایل اصلی کرون WHMCS |
مسیر بالا یک نمونه است و نباید بدون بررسی در تمام سرورها استفاده شود. مسیر پوشه crons ممکن است با توجه به محل نصب WHMCS یا تنظیمات امنیتی سرور متفاوت باشد. در بعضی نصبها نیز این پوشه از مسیر اصلی سایت خارج شده است. برای دریافت دستور دقیق متناسب با نصب خود، وارد پنل مدیریت WHMCS شوید و مسیر زیر را دنبال کنید:
- وارد بخش Configuration شوید.
- گزینه System Settings را انتخاب کنید.
- وارد صفحه Automation Settings شوید.
- روی اولین نشان یا Badge مربوط به تنظیمات کرون کلیک کنید.
- دستور پیشنهادی WHMCS را مشاهده و کپی کنید.
این دستور مسیر صحیح فایل کرون و اطلاعات لازم برای اجرای آن را در اختیار شما قرار میدهد.
کرون جاب WHMCS هر چند دقیقه باید اجرا شود؟
فاصله اجرای کرون جاب WHMCS به توصیه مستندات رسمی این نرمافزار بهتر است پنج دقیقه باشد. در این حالت، اسکریپت cron.php هر پنج دقیقه اجرا میشود و وظایفی را که زمان اجرای آنها رسیده است، بررسی میکند.
البته اجرای کرون هر پنج دقیقه به این معنی نیست که تمام وظایف WHMCS نیز هر پنج دقیقه انجام میشوند. هر وظیفه زمانبندی مخصوص خود را دارد؛ برای مثال، صدور صورتحسابها و بسیاری از عملیات روزانه فقط در زمان تعیینشده اجرا میشوند.
در تنظیمات WHMCS میتوانید زمان اجرای وظایف روزانه را نیز مشخص کنید:
- به بخش Configuration > System Settings > Automation Settings بروید.
- قسمت Scheduling را پیدا کنید.
- مقدار گزینه Time of Day را بررسی کنید.
- ساعت موردنظر را با توجه به منطقه زمانی سرور تنظیم کنید.
اگر زمان اجرای وظایف روزانه را ساعت ۹ صبح قرار دادهاید، کرون جاب باید در همان بازه زمانی فعال باشد تا WHMCS بتواند عملیات روزانه را اجرا کند. همچنین منطقه زمانی تنظیمشده در WHMCS باید با منطقه زمانی سرور هماهنگ باشد؛ در غیر این صورت ممکن است صدور صورتحساب یا ارسال یادآوریها در ساعت مورد انتظار انجام نشود.
چگونه خطاهای کرون جاب WHMCS را بررسی کنیم؟
بررسی خروجی خطای کرون جاب WHMCS به شما کمک میکند متوجه شوید که اسکریپت cron.php بهدرستی اجرا شده است یا در یکی از وظایف خودکار با مشکل مواجه شده است. گاهی اوقات کرون اجرا میشود، اما یک وظیفه مشخص مانند صدور صورتحساب یا همگامسازی اطلاعات دامنه با خطا روبهرو میشود. برای بررسی وضعیت اجرای کرون، دو بخش مهم در WHMCS وجود دارد:
بررسی وضعیت کرون از طریق Automation Status
بخش Automation Status گزارشی از اجرای وظایف خودکار WHMCS ارائه میدهد. برای مشاهده این گزارش مراحل زیر را انجام دهید:
- وارد پنل مدیریت WHMCS شوید.
- از منوی Utilities گزینه Automation Status را انتخاب کنید.
- وضعیت کلی اجرای کرون را در بالای صفحه بررسی کنید.
- در صورت مشاهده خطا، روی وضعیت کرون کلیک کنید تا جزئیات اجرای وظایف نمایش داده شود.
- وظایفی را که با علامت خطا مشخص شدهاند بررسی کنید و از گزینه Learn more برای مشاهده راهنمای رفع مشکل استفاده کنید.
در این بخش میتوانید اطلاعاتی مانند تعداد صورتحسابهای ایجادشده، یادآوریهای پرداخت ارسالشده و وضعیت اجرای وظایف روزانه را مشاهده کنید.
بررسی خطاهای کرون در System Logs
بخش System Logs جزئیات بیشتری از اجرای کرون جاب WHMCS در اختیار شما قرار میدهد. برای بررسی گزارشها به مسیر زیر بروید:
Configuration > System Logs
در این قسمت باید گزارشهایی با عنوان Cron Job مشاهده کنید. اگر اجرای وظایف روزانه بهدرستی انجام شده باشد، آخرین گزارش مربوط به آن روز باید با عنوان زیر ثبت شده باشد:
Cron Job: Completed
اگر هیچ گزارشی از اجرای کرون وجود ندارد، احتمال دارد دستور کرون بهدرستی تنظیم نشده باشد. اگر گزارش شروع اجرا وجود دارد اما پیام تکمیل ثبت نشده است، باید خطاهای مربوط به اجرای اسکریپت را بررسی کنید.
مشاهده جزئیات خطا با دستور کرون
مشاهده خروجی خطای کرون جاب WHMCS از طریق خط فرمان روش دیگری برای شناسایی مشکلات است. اگر گزارشهای پنل مدیریت اطلاعات کافی ارائه نمیدهند، میتوانید دستور کرون را با سطح جزئیات بیشتر اجرا کنید.
برای این کار، ابتدا از مسیر Utilities > Automation Status دستور کرون نصب خود را کپی کنید. سپس در محیط خط فرمان سرور، عبارت زیر را به انتهای دستور اضافه کنید:
all -F -vvv
دستور کامل به شکل زیر خواهد بود:
php -q /home/username/crons/cron.php all -F -vvv
در این دستور:
- all اجرای تمام وظایف خودکار را درخواست میکند.
- -F اجرای اجباری وظایف را حتی در صورت اجرا شدن قبلی آنها امکانپذیر میکند.
- –vvv سطح جزئیات خروجی را به حداکثر میرساند تا اطلاعات بیشتری درباره مراحل اجرا و خطاهای احتمالی نمایش داده شود.
در صورت اجرای موفق، خروجی دستور با پیام زیر پایان مییابد:
[OK] Completed
اجرای دستور با گزینه -F ممکن است وظایف روزانه را دوباره اجرا کند؛ بنابراین WHMCS توصیه میکند این روش را برای عیبیابی بیشتر از یک بار در هر ۲۴ ساعت انجام ندهید. همچنین بهتر است پیش از اجرای آن، از دادههای مهم نسخه پشتیبان داشته باشید.
اگر مشکل اجرای کرون بهصورت متناوب اتفاق میافتد، میتوانید خروجی آن را در یک فایل ذخیره کنید تا امکان بررسی خطاهای اجرای قبلی نیز وجود داشته باشد. برای نمونه، در مستندات WHMCS استفاده از -vvv >> crondebug.txt برای ثبت خروجی در فایل گزارش پیشنهاد شده است.
تفاوت کرون جاب WHMCS با کرون جاب سایت چیست؟
تفاوت کرون جاب WHMCS با کرون خود سایت در وظیفهای است که هرکدام اجرا میکنند. کرون WHMCS برای مدیریت عملیات زمانبندیشده داخل نرمافزار WHMCS طراحی شده است؛ اما کرون اختصاصی یک سایت یا اسکریپت دیگر، وظایف مربوط به همان برنامه را اجرا میکند.
ممکن است یک وبسایت فروشگاهی برای بهروزرسانی اطلاعات محصولات یا پاکسازی دادههای موقت، اسکریپتهای زمانبندیشده داشته باشد. این وظایف ارتباط مستقیمی با صدور صورتحساب و تمدید دامنه در WHMCS ندارند. از طرف دیگر، کرون جاب WHMCS برای اجرای وظایفی مانند ایجاد فاکتور تمدید، ارسال یادآوری پرداخت و بررسی اطلاعات دامنه به اسکریپت اختصاصی خودش نیاز دارد.
کرون WHMCS و کرون سایت دو ابزار زمانبندی مستقل نیستند. در نصبهای Self-Hosted، زمانبند سیستمعامل یا سرویس زمانبندی هاست، دستور اجرای فایل cron.php را در زمانهای مشخص فراخوانی میکند. بنابراین کرون WHMCS از زمانبند سرور برای اجرای وظایف داخلی خود استفاده میکند.
به همین دلیل، برای راهاندازی کرون WHMCS باید هم دستور اجرای فایل اختصاصی این نرمافزار را داشته باشید و هم زمانبندی اجرای آن را درست تنظیم کنید.
اگر با مفهوم زمانبندی دستورات در لینوکس آشنا نیستید، مقاله کرون جاب cron job در لینوکس اطلاعات بیشتری درباره سازوکار زمانبند لینوکس ارائه میدهد. در مقابل، برای آشنایی با خود نرمافزار و کاربردهای آن میتوانید راهنمای WHMCS چیست را مطالعه کنید.
کرون جاب WHMCS با کرون جاب سیپنل یا دایرکت ادمین یکسان نیست. سیپنل و دایرکت ادمین صرفاً محیطهایی برای ثبت و زمانبندی دستور اجرای کرون WHMCS هستند. در هر دو پنل میتوانید فایل cron.php را طبق فاصله زمانی موردنظر اجرا کنید؛ اما وظایفی مانند صدور صورتحساب، ارسال یادآوری پرداخت و بررسی وضعیت دامنهها را خود WHMCS انجام میدهد.
جمعبندی
کرون جاب WHMCS یکی از بخشهای مهم مدیریت خودکار هاستینگ است که وظایفی مانند صدور صورتحساب، ارسال یادآوری پرداخت و بررسی وضعیت دامنهها را انجام میدهد. برای عملکرد صحیح این قابلیت، باید دستور اجرای cron.php را مطابق مسیر نصب WHMCS تنظیم کنید و اجرای آن را در فاصلههای زمانی مناسب، ترجیحاً هر پنج دقیقه، قرار دهید.
همچنین بررسی منظم گزارشهای Automation Status و System Logs کمک میکند خطاهای احتمالی را پیش از ایجاد اختلال در فرایند صورتحساب و تمدید دامنه شناسایی کنید. اگر برای اجرای صحیح WHMCS به منابع پردازشی اختصاصیتر نیاز دارید، میتوانید مشخصات و پلنهای سرور مجازی NVMe روناک هاست را بررسی کنید.
آیا کرون جاب WHMCS باید همیشه فعال باشد؟
بله. در نصبهای Self-Hosted، کرون جاب WHMCS باید طبق برنامه زمانی مشخص اجرا شود تا عملیات خودکار مانند صدور صورتحساب و ارسال یادآوریها با تأخیر مواجه نشوند. در نسخه WHMCS Cloud، تنظیمات اجرای کرون بر عهده ارائهدهنده سرویس است.
اگر کرون جاب WHMCS اجرا نشود چه اتفاقی میافتد؟
در صورت اجرا نشدن کرون، وظایفی مانند ایجاد فاکتورهای تمدید، ارسال اعلانهای پرداخت و همگامسازی اطلاعات دامنه ممکن است انجام نشوند. در نتیجه، مشتریان فاکتور یا یادآوریهای موردنیاز را بهموقع دریافت نمیکنند و مدیریت تمدید سرویسها با مشکل مواجه میشود.
چرا با وجود اجرای کرون، فاکتور تمدید دامنه صادر نمیشود؟
صدور نشدن فاکتور تمدید دامنه همیشه به معنی خرابی کرون نیست. برای بررسی این مشکل، ابتدا وضعیت دامنه را بررسی کنید و مطمئن شوید گزینه Disable Auto Renew فعال نباشد. سپس مقدار Next Due Date را با تنظیم Invoice Generation در بخش Automation Settings مقایسه کنید. همچنین باید بررسی کنید که فاکتور تمدید قبلاً ایجاد یا حذف نشده باشد.
آیا اجرای کرون هر پنج دقیقه باعث صدور چندباره فاکتور میشود؟
خیر. WHMCS وظایف خودکار را بر اساس زمانبندی داخلی و وضعیت فاکتورها مدیریت میکند و اجرای کرون در فاصله پنجدقیقهای به معنی صدور فاکتور در هر پنج دقیقه نیست. بااینحال، نباید چند دستور زمانبندیشده بهطور همزمان یک فایل cron.php را اجرا کنند؛ زیرا اجرای همزمان چند نمونه کرون میتواند باعث ایجاد فاکتورهای تکراری شود.





