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

Scheduled Tasks در Plesk: کران‌جاب امن با لاگ و بدون هم‌پوشانی

در Plesk وظیفهٔ زمان‌بندی‌شده را با مسیر مطلق، باینری درست PHP، لاگ و قفل بسازید تا اجراها هم‌پوشانی نکنند.

Scheduled Tasks در Plesk: کران‌جاب امن با لاگ و بدون هم‌پوشانی

Plesk کران‌جاب‌ها را «Scheduled Tasks» می‌نامد. اضافه‌کردنشان آسان است و بی‌صدا غلط‌شدنشان هم: مسیر نسبی، نسخهٔ اشتباه PHP یا کاری که با خودش هم‌پوشانی دارد می‌تواند بی‌خبر شکست بخورد. این راهنما نشان می‌دهد چطور وظیفه‌ای امن بسازید، خروجی‌اش را لاگ کنید، از اجرای هم‌زمان جلوگیری کنید و بسنجید واقعاً اجرا شده یا نه. نام منوها از دانش خودم است و بسته به نسخهٔ Plesk فرق می‌کند.

۱. وظیفه را با مسیر مطلق بسازید

در صفحهٔ Scheduled Tasks اشتراک، نوع وظیفه (اجرای دستور، اجرای اسکریپت PHP یا واکشی URL) و زمان‌بندی را بگذارید. برای دستور مسیر کامل بنویسید، چون cron محیط حداقلی و پوشهٔ کاری متفاوت دارد:

# Task type: Run a command (example)
/usr/bin/php -q /var/www/vhosts/example.com/httpdocs/cron.php

# Better: absolute paths and logging
/usr/bin/php -q /var/www/vhosts/example.com/httpdocs/cron.php >> /var/www/vhosts/example.com/logs/cron.log 2>&1

افزودن خروجی به فایل لاگ هنگام شکست چیزی برای خواندن به شما می‌دهد.

۲. باینری درست PHP را انتخاب کنید

Plesk می‌تواند چند نسخهٔ PHP داشته باشد. وظیفه‌ای که php ساده را صدا می‌زند ممکن است نسخه‌ای متفاوت از وب‌سایت استفاده کند. ببینید کدام استفاده می‌شود و باینری متناسب را صریح صدا بزنید:

which php
/opt/plesk/php/8.2/bin/php -v
crontab -l
grep CRON /var/log/syslog | tail -n 20      # Debian/Ubuntu
grep CRON /var/log/cron | tail -n 20         # RHEL family

اگر سایت PHP 8.2 دارد ولی وظیفه 7.4 اجرا می‌کند، افزونه‌ها فقط در وظیفه خطا می‌دهند. برای تنظیمات PHP هر سایت راهنمای PHP را ببینید.

۳. جلوی هم‌پوشانی را بگیرید

اگر کاری از فاصلهٔ خود طولانی‌تر شود نسخهٔ دوم شروع می‌شود و ممکن است کار هم را خراب یا سرور را سنگین کنند. دستور را با flock بپیچید تا اگر اجرای قبلی هنوز کار می‌کند اجرای جدید خارج شود:

# Prevent overlapping runs
/usr/bin/flock -n /tmp/mytask.lock /usr/bin/php -q /var/www/vhosts/example.com/httpdocs/cron.php

فاصلهٔ معقول انتخاب کنید. خیلی از کارها لازم نیست هر دقیقه اجرا شوند.

۴. تأیید کنید واقعاً اجرا شده

بعد از اولین زمان برنامه‌ریزی‌شده لاگ cron سیستم و لاگ خودتان را بخوانید. اگر پنل گزینهٔ اعلان خطا دارد فعالش کنید تا خروجی برایتان ایمیل شود. کاری که بی‌صدا شکست بخورد از نبودن کار بدتر است. برای زمان‌بندی سنگین‌تر یا وابسته به سرویس روی سرور خودتان راهنمای تایمرهای systemd را ببینید.

۵. اشتباه‌های رایج

این الگوها بیشتر گزارش‌های «وظیفه هیچ کاری نمی‌کند» را می‌سازند:

php cron.php                       # relative path, wrong working directory
* * * * * heavy-task               # every minute with no lock
curl http://example.com/cron.php   # may be cached or blocked

واکشی URL می‌تواند توسط CDN کش یا توسط قاعدهٔ امنیتی مسدود شود، در حالی که اجرای مستقیم اسکریپت این مشکل‌ها را ندارد. هنگام تعیین ساعت منطقهٔ زمانی سرور را در نظر بگیرید.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید وظیفه‌ای شبانه (ساختگی) باید فایل‌های قدیمی را پاک کند ولی ظاهراً هرگز اجرا نمی‌شود. دستور مسیر نسبی داشت و خروجی به جایی نمی‌رفت. تغییر به مسیر مطلق و افزودن خروجی به لاگ در اولین اجرا پیام «file not found» نشان می‌دهد. بعد از اصلاح مسیر و افزودن قفل، لاگ هر شب یک اجرای تمیز نشان می‌دهد.

۷. اشتباه‌های رایج

  • مسیر نسبی در دستور.
  • صدازدن نسخهٔ اشتباه PHP.
  • نبود لاگ خروجی.
  • اجرای کار سنگین هر دقیقه.
  • نبود قفل در برابر هم‌پوشانی.
  • نادیده‌گرفتن منطقهٔ زمانی سرور.

۸. پرسش‌های متداول

Scheduled Tasks در Plesk کجاست؟ در صفحهٔ Scheduled Tasks اشتراک یا در Tools & Settings برای وظایف سطح سیستم.

چرا وظیفه نسخهٔ دیگری از PHP استفاده می‌کند؟ چون دستور ساده php ممکن است به باینری متفاوتی از handler سایت اشاره کند.

هر چند وقت یک بار اجرا شود؟ فقط به‌اندازهٔ نیاز کار. از زمان‌بندی هر دقیقه برای کار سنگین پرهیز کنید.

چطور جلوی هم‌پوشانی را بگیرم؟ از flock یا فایل قفل داخل اسکریپت استفاده کنید.

۹. چک‌لیست سریع

  1. مسیر مطلق بنویسید.
  2. باینری درست PHP را صدا بزنید.
  3. خروجی را به لاگ اضافه کنید.
  4. برای کار طولانی flock بگذارید.
  5. منطقهٔ زمانی سرور را ببینید.
  6. اولین اجرا را در لاگ تأیید کنید.
  7. وظیفه را بعد از به‌روزرسانی PHP مرور کنید.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

Plesk docs: Scheduling tasks · Plesk docs: Administrator Guide · crontab(5) manual · flock(1) manual