Планировщик Laravel на сервере: одна строка в cron
Задачи по расписанию Laravel описывает в коде проекта, а запускает их одна строка в cron: раз в минуту она вызывает php artisan schedule:run, и Laravel сам решает, какие задачи пора выполнить. Если строки нет, ни одна задача по расписанию не сработает.
Содержание 10
Что сделать прямо сейчас
- Откройте расписание cron пользователя сайта:
sudo crontab -u www-data -e. - Добавьте в конец строку из примера ниже и сохраните файл.
- Проверьте список задач:
cd /var/www/example.comиphp artisan schedule:list. - Через пару минут посмотрите журнал cron:
grep CRON /var/log/syslog | tail -n 5.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Проект в примерах лежит в /var/www/example.com.
Строка для cron
* * * * * cd /var/www/example.com && php artisan schedule:run >> /dev/null 2>&1| Часть | Что значит |
|---|---|
* * * * * | запускать каждую минуту |
cd /var/www/example.com | перейти в папку проекта |
php artisan schedule:run | запустить задачи, которым подошло время |
>> /dev/null 2>&1 | не сохранять вывод команды |
Строку добавьте в расписание пользователя www-data — от него работает сайт, и файлы кеша и журнала останутся ему доступны:
sudo crontab -u www-data -eПри первом запуске система спросит, в каком редакторе открыть файл, — выберите nano, цифру напротив него. Вставьте строку в конец файла, сохраните: Ctrl+O, Enter, выход — Ctrl+X. Проверьте, что строка сохранилась: sudo crontab -u www-data -l.
Как устроены пять звёздочек — в статье Как добавить задачу в cron. Про редактор — crontab -e.
Где описаны задачи
Задачи пишут в файле routes/console.php проекта. Пример из документации Laravel:
use Illuminate\Support\Facades\Schedule;
Schedule::command('emails:send Taylor --force')->daily();| Метод | Когда запускать |
|---|---|
->everyMinute() | каждую минуту |
->everyFiveMinutes() | каждые 5 минут |
->hourly() | каждый час |
->daily() | каждый день в полночь |
->dailyAt('13:00') | каждый день в 13:00 |
->weekly() | раз в неделю |
Это код проекта — его пишет разработчик. На сервере достаточно строки cron.
Как проверить
cd /var/www/example.com
php artisan schedule:listКоманда покажет задачи и когда каждая сработает в следующий раз. Ответ No scheduled tasks have been defined. значит, что в проекте нет ни одной задачи по расписанию — cron тут ни при чём.
Запустите планировщик руками от пользователя сайта:
sudo -u www-data php artisan schedule:run| Ответ | Что значит |
|---|---|
строка со словом Running и именем задачи | задача запущена |
No scheduled commands are ready to run. | сейчас ни одной задаче не пора — это не ошибка |
Проверить, что cron вызывает команду каждую минуту:
grep CRON /var/log/syslog | tail -n 5В строках должно быть (www-data) CMD (cd /var/www/example.com && php artisan schedule:run …).
Часовой пояс
Время задач Laravel считает по часовому поясу приложения. В новом проекте это UTC: строка 'timezone' => 'UTC' в файле config/app.php. Задача ->dailyAt('13:00') сработает в 13:00 по UTC — в 16:00 по Москве.
Чтобы считать расписание по московскому времени, допишите в config/app.php строку:
'schedule_timezone' => 'Europe/Moscow',Или укажите пояс у одной задачи:
Schedule::command('report:generate')
->timezone('Europe/Moscow')
->at('02:00');После правки config/app.php соберите кеш настроек: sudo -u www-data php artisan config:cache.
Чтобы задача не запускалась дважды
Если задача идёт дольше, чем интервал между запусками, новая копия запустится поверх старой. Это запрещает метод withoutOverlapping():
Schedule::command('emails:send')->withoutOverlapping();Laravel ставит отметку в кеше, пока задача идёт. Если задачу прервали посреди работы, отметка остаётся до 24 часов, и задача не запускается. Снять её:
php artisan schedule:clear-cacheЕсли у сайта несколько серверов с одной базой, задачу на одном сервере запускает ->onOneServer(). Для этого кеш приложения должен быть общим: database, redis или memcached.
Режим обслуживания и выкладка
Пока сайт в режиме обслуживания (php artisan down), задачи по расписанию не выполняются. Если задача нужна и в это время, у неё должен быть метод ->evenInMaintenanceMode(). Подробнее — Режим обслуживания.
Если в проекте есть задачи с интервалом меньше минуты, например ->everyTenSeconds(), команда schedule:run работает до конца минуты. После выкладки нового кода прервите её, чтобы следующая минута началась с новым кодом:
php artisan schedule:interruptКоманда php artisan reload делает это сама — Выкладка обновлений.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
| задачи не выполняются | нет строки в cron | добавьте строку |
| в журнале cron нет строк про schedule:run | строка в чужом расписании или с ошибкой | sudo crontab -u www-data -l |
No scheduled tasks have been defined. | в проекте нет задач | задачи пишут в routes/console.php |
| задачи срабатывают на 3 часа раньше | расписание по UTC | укажите пояс |
| задача перестала запускаться | осталась отметка withoutOverlapping | php artisan schedule:clear-cache |
laravel.log could not be opened | строка cron в расписании root | перенесите строку к www-data и верните права |
errors in crontab file, can't install | ошибка в строке cron | Разбор |
Could not open input file: artisan | нет cd в папку проекта | Разбор |
Тексты сообщений сверены по исходному коду Laravel 13.42.0.
Источники
- Документация Laravel: Task Scheduling — на английском: строка cron, schedule:list, часовые пояса, withoutOverlapping и schedule:interrupt.
- Исходный код команды schedule:run в Laravel 13.42.0 — на английском: текст No scheduled commands are ready to run.
- Шаблон config/app.php — на английском: часовой пояс UTC.
- Справка crontab в Ubuntu 24.04 — на английском: ключи -u, -e и -l.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Laravel на серверевсе статьи о работе проекта на VPS.
- Очереди и Supervisorворкеры для долгих задач.
- Cron для PHP-скриптакак запускать PHP по расписанию.