Планировщик 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().