На многих сайтах часть работы привязана не к нажатию кнопки, а ко времени: ночная отправка отчётов, ежечасное обновление курса валют, очистка брошенных корзин или рассылка подписчикам. Чтобы такие повторяющиеся задачи выполнял сам сервер, используется cron. В ISPmanager задания cron создаются в разделе «Планировщик» и запускаются от имени пользователя вашего хостинг-аккаунта. Правильно настроенный cron работает незаметно, а настроенный неправильно либо не работает вовсе, либо зря нагружает сервер.
Как читать расписание cron
Каждое задание состоит из расписания из пяти полей и команды. Порядок полей: минута, час, день месяца, месяц и день недели. Звёздочка означает «каждый», а */5 — «каждый пятый». Несколько типичных примеров:
| Расписание | Значение |
|---|---|
*/5 * * * * | каждые 5 минут |
0 * * * * | в начале каждого часа |
30 3 * * * | каждый день в 03:30 |
0 9 * * 1 | каждый понедельник в 09:00 |
0 2 1 * * | 1-го числа каждого месяца в 02:00 |
Время считается по часовому поясу сервера. Если важно, чтобы задание срабатывало в точный час, после первого запуска проверьте по логу, что оно выполнилось в ожидаемое время.
Создание задания в ISPmanager
Войдите в ISPmanager из кабинета sayt.uz и откройте в левом меню «Планировщик (cron)» (в английском интерфейсе — Cron jobs). При нажатии кнопки создания появятся поля:
- Команда — что выполнять; пути к файлам указываются полностью.
- Расписание — в базовом режиме выбирается из списков, в режиме эксперта пять полей вводятся напрямую.
- Отправлять результат на почту — если включено, всё, что выводит команда, придёт письмом. Полезно при отладке, но при постоянной работе засоряет почту.
- Комментарий — напишите, зачем нужно задание; через несколько месяцев это очень пригодится.
Не используйте в команде относительные пути: cron запускается не в папке сайта, а в домашнем каталоге пользователя. В ISPmanager файлы сайта обычно лежат в папке вида /var/www/ПОЛЬЗОВАТЕЛЬ/data/www/misol.uz; точный путь можно посмотреть в файловом менеджере панели.
Запуск PHP-скрипта через cron
Есть два способа запустить PHP-файл. Первый — напрямую вызвать интерпретатор PHP. Важно указать путь именно к той версии, на которой работает сайт, потому что команда php может вызвать другую, более старую версию. Дополнительные версии на сервере обычно находятся по путям вроде /opt/php82/bin/php; точный путь можно уточнить в техподдержке:
/opt/php82/bin/php /var/www/u1234/data/www/misol.uz/cron/rates.php >/dev/null 2>&1
Второй способ — вызвать скрипт через веб. Это удобно, если скрипт корректно работает только через браузер, но защитите такой адрес секретным ключом, чтобы его не могли открыть посторонние:
wget -q -O /dev/null "https://misol.uz/cron/rates.php?key=длинный-случайный-ключ"
Окончание >/dev/null 2>&1 отбрасывает вывод. Если вывод нужно сохранить, направьте его в лог, например >> $HOME/cron-rates.log 2>&1. Так легко понять, выполнилось ли задание и не было ли ошибок.
Пример: турагентство и курс валют
Турагентство в Бухаре показывает на сайте misol.uz цены туров в долларах и сумах. Курс должен обновляться каждый час, поэтому разработчик написал скрипт rates.php, который получает курс и записывает его в базу. В планировщике задаётся расписание 0 * * * *, а команда записывается, как в первом примере выше. В первый день вывод пишется в лог, а убедившись, что всё работает, лог сокращают до записи только ошибок.
Если скрипт иногда работает дольше часа, следующий запуск наложится на предыдущий и в базе появится путаница. Чтобы этого не случилось, используют flock: он не запустит новую копию, пока не завершилась прежняя:
flock -n $HOME/rates.lock /opt/php82/bin/php /var/www/u1234/data/www/misol.uz/cron/rates.php
Cron для WordPress и Laravel
WordPress выполняет свои запланированные задачи через wp-cron.php и по умолчанию проверяет их при каждом открытии страницы. На малопосещаемом сайте задачи запаздывают, на посещаемом создаётся лишняя нагрузка. Лучше добавить в wp-config.php строку define( 'DISABLE_WP_CRON', true ); и запускать настоящий cron каждые 5 или 15 минут:
*/15 * * * * wget -q -O /dev/null "https://misol.uz/wp-cron.php?doing_wp_cron"
В проектах на Laravel все запланированные задачи описываются в коде, а cron лишь раз в минуту запускает одну команду:
* * * * * cd /var/www/u1234/data/www/misol.uz && /opt/php82/bin/php artisan schedule:run >> /dev/null 2>&1
Что проверить, если задание не работает
Сначала запустите команду вручную по SSH: если она падает и в терминале, проблема не в cron, а в самом скрипте. Если в терминале всё работает, а в cron нет, причина обычно в относительных путях, другой версии PHP или отсутствующих переменных окружения. Временно включив отправку результата на почту, вы получите текст ошибки письмом. Избегайте тяжёлых заданий, выполняемых каждую минуту: они зря расходуют ресурсы хостинга и могут упереться в лимиты тарифа. Если остались вопросы, отправьте в техподдержку sayt.uz тикет с командой и расписанием задания.