Поиск
Справочник

Планировщик Laravel на сервере: одна строка в cron

Задачи по расписанию Laravel описывает в коде проекта, а запускает их одна строка в cron: раз в минуту она вызывает php artisan schedule:run, и Laravel сам решает, какие задачи пора выполнить. Если строки нет, ни одна задача по расписанию не сработает.

≈ 6 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Откройте расписание cron пользователя сайта: sudo crontab -u www-data -e.
  2. Добавьте в конец строку из примера ниже и сохраните файл.
  3. Проверьте список задач: cd /var/www/example.com и php artisan schedule:list.
  4. Через пару минут посмотрите журнал 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укажите пояс
задача перестала запускатьсяосталась отметка withoutOverlappingphp 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.

Источники

Сверено 13 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше