Планировщик CRON: задания по расписанию

CRON-задание — команда, которая выполняется на сервере автоматически по расписанию: раз в час, раз в сутки или по любому другому графику. Пригодится для регулярных задач сайта — обработки очередей, рассылок, резервных выгрузок, служебных скриптов CMS, которые иначе пришлось бы запускать вручную.

Где создать задание

Откройте в панели раздел «Планировщик CRON». Список заданий пуст, пока вы не создали ни одного, — нажмите «Создать задание».

Форма нового задания

• Адрес e-mail — куда придёт отчёт о выполнении (вывод команды и ошибки, если они есть);
• Дата и время сервера — справочное поле, чтобы свериться с часовым поясом сервера при настройке расписания: время в CRON указывается именно по нему;
• Команда — что выполнять (см. примеры ниже);
• Описание — произвольная пометка для себя, чтобы через месяц не гадать, зачем создано задание;
• Включено — снимите галочку, чтобы приостановить задание, не удаляя его;
• Не отправлять отчёт по e-mail — если письмо на каждый запуск не нужно, особенно при частых заданиях (например, раз в минуту).

Расписание: базовый режим

По умолчанию выбран базовый режим — частота из выпадающего списка «Выполнять» (например, ежедневно) и точное время в полях «Выполнить в» (час и минуты). Понятный вариант для большинства задач: «раз в сутки в 3:00 ночи», «раз в неделю» и подобных.

Расписание: экспертный режим

Для точного контроля или нестандартных интервалов (например, «каждые 5 минут» или «по будням в 9 и 18 часов») переключитесь на экспертный режим — откроются пять классических полей crontab: минуты, часы, дни месяцев, месяцы, дни недели. Работают стандартные правила cron: конкретное число, список через запятую, диапазон через дефис или шаг через / (например, */5 в минутах — каждые 5 минут).

Что писать в поле «Команда»

Два частых случая:

• Обращение к странице сайта — если задача реализована как PHP-скрипт, который должен выполняться по URL:

  curl -s https://вашдомен.ru/cron/task.php
  

• Запуск PHP-скрипта или консольной команды напрямую — тогда команде нужен полный путь к интерпретатору нужной версии PHP и к самому скрипту. Путь к интерпретатору версии, которую использует сайт, показан в настройках сайта (блок «Обработчик (PHP)» → «Путь к интерпретатору PHP»), например:

  /opt/alt/php84/usr/bin/php /var/www/логин/data/www/вашдомен.ru/script.php
  

  Указывайте именно этот путь, а не просто php, — иначе команда может выполниться на системной версии PHP, отличной от версии вашего сайта.

Планировщик Laravel и других фреймворков

Если хостинг заказан с окружением под фреймворк (Laravel), задания очереди и schedule:run уже настроены автоматически при провижининге сайта — создавать их вручную не нужно и не стоит: можно получить дубли обработки. Здесь же, в разделе «Планировщик CRON», их можно посмотреть, приостановить или отредактировать, если требуется нестандартный график.

Частые вопросы

Какой часовой пояс у расписания? Часовой пояс сервера — он показан в поле «Дата и время сервера» формы задания при создании.

Как временно отключить задание, не удаляя его? Откройте задание и снимите галочку «Включено». Можно и просто выделить задание в списке и нажать соответствующую кнопку на панели инструментов раздела.

Приходит слишком много писем с отчётами. Отметьте «Не отправлять отчёт по e-mail» в настройках задания — особенно полезно для заданий, которые выполняются чаще раза в час.

Задание не выполняется или выполняется не вовремя. Проверьте расписание в экспертном режиме — легко ошибиться с полями crontab (перепутать порядок минут и часов). Если расписание верное, а команда так и не отработала, посмотрите отчёт на почте (там видны ошибки выполнения) или напишите в поддержку.

Команда работает в SSH, а по расписанию — нет. Чаще всего дело в путях: в SSH-сессии используются алиасы и переменные окружения профиля, которых в CRON нет. Указывайте полный путь и к интерпретатору PHP, и к самому скрипту — так, как описано выше.

Можно ли запускать задание раз в минуту? Да, в экспертном режиме укажите * в поле «Минуты» — но для таких частых заданий обязательно отключите отчёт по e-mail, иначе почтовый ящик быстро заполнится письмами.