Планировщик Laravel не работает сам по себе. Ему нужен один системный cron, который раз в минуту запускает schedule:run. Дальше Laravel смотрит расписание и решает, какие задачи выполнить.
Одна строка в cron
В панели хостинга добавьте задачу:
* * * * * php8.3 /home/USER/site.ru/artisan schedule:run >> /home/USER/schedule.log 2>&1
Важны три вещи: полный путь к PHP, полный путь к artisan и запись вывода в файл. cron запускается не из каталога проекта, поэтому относительные пути не работают.
Если хостинг даёт только веб-панель, ищите поле «команда» и «расписание»; команда остаётся той же.
Как описывать задачи
use Illuminate\Support\Facades\Schedule;
Schedule::command('backup:run')->dailyAt('03:00');
Schedule::command('queue:work --stop-when-empty')->everyFiveMinutes()->withoutOverlapping();
Schedule::command('posts:reindex')->weeklyOn(1, '04:30');
withoutOverlapping() не даёт запустить вторую копию, пока работает первая. Для нескольких серверов нужен onOneServer(), но он требует общего кэша — на одном сервере это не обязательно.
Часовой пояс
По умолчанию планировщик использует app.timezone, обычно Europe/Moscow. Но cron на сервере может работать по UTC. Тогда задача «в 03:00» запустится в 06:00 по Москве. Проверьте время командой date и при необходимости задайте timezone() у расписания.
Schedule::command('report:send')->dailyAt('09:00')->timezone('Europe/Moscow');
Почему задача не запускается
- в cron указан
phpвместоphp8.3, а версия по умолчанию отличается; - нет прав на запись в лог или кэш;
- команда содержит
%— в crontab его нужно экранировать обратным слешем; - задача перекрыта предыдущим запуском: проверьте
withoutOverlapping()и зависшие процессы; - расписание закешировано: после деплоя выполните
php8.3 artisan schedule:clear-cache; - ошибка есть, но вывод уходит в
/dev/null— писать в лог обязательно.
Проверка без ожидания
Посмотреть список задач и ближайшие запуски:
php8.3 artisan schedule:list
php8.3 artisan schedule:test
Запустить конкретную команду вручную:
php8.3 artisan backup:run
Если вручную работает, а по расписанию нет — проблема почти всегда в cron, путях или правах, а не в коде задачи.
Логи и уведомления
Пишите вывод в отдельный файл и периодически смотрите его. Для критичных задач добавьте уведомление в Telegram или почту при ошибке. Не полагайтесь на «тихий» cron: сбой без лога можно заметить через недели.
Коротко
- один cron-вызов
schedule:runраз в минуту; - полные пути к PHP и artisan;
- лог вместо
/dev/null; - часовой пояс сервера проверяйте отдельно;
- для пересекающихся задач —
withoutOverlapping().