К содержимому

Cron для планировщика Laravel: настройка и проверка

Планировщик Laravel запускается одной строкой в crontab: каждую минуту вызывается php artisan schedule:run, а Laravel сам решает, какие задачи выполнить. Добавьте эту строку пользователю, от которого работает сайт, и проверьте, что задания появляются в расписании.

Конфиг Cron 3 мин чтения

Конфиг

crontab пользователя сайта
* * * * * cd /var/www/example.com && php artisan schedule:run >> /dev/null 2>&1

Что заменить под свой сервер

/var/www/example.com
папка проекта

Как применить и проверить

bash
sudo crontab -u www-data -e
sudo crontab -u www-data -l
php artisan schedule:list

Что делает строка crontab

Строка * * * * * cd /var/www/example.com && php artisan schedule:run >> /dev/null 2>&1 каждую минуту переходит в папку проекта и запускает команду планировщика. Laravel сверяет текущее время с расписанием из app/Console/Kernel.php или routes/console.php и выполняет только те задачи, чей час наступил. Вывод команды отбрасывается в /dev/null, поэтому почта от cron не приходит.

Под какого пользователя ставить задание

Cron должен работать от того же пользователя, что и PHP-FPM, иначе Laravel не сможет писать в storage/logs и кеш. На Ubuntu 24.04 с nginx и PHP 8.3 это обычно www-data. Команда sudo crontab -u www-data -e открывает crontab этого пользователя в редакторе. Если сайт настроен под отдельного пользователя, укажите его имя вместо www-data.

Замена пути к проекту

В строке замените /var/www/example.com на абсолютный путь к папке, где лежит artisan. Проверить путь можно командой pwd из корня проекта. Если оставить чужой путь, cron будет каждую минуту писать ошибку в системный лог, а задачи не выполнятся.

Проверка установленного задания

Команда sudo crontab -u www-data -l выводит текущий crontab пользователя. Убедитесь, что строка с schedule:run присутствует и путь в ней верный. Если вывод пуст, задание не сохранилось: повторите редактирование и выйдите из редактора с сохранением.

Проверка расписания в Laravel

Команда php artisan schedule:list показывает все задачи, которые Laravel знает, с временем следующего запуска. Запускайте её из папки проекта от пользователя www-data или от своего, но с теми же правами на файлы. Если список пуст, задачи не зарегистрированы в коде, и cron тут ни при чём.

Как убедиться, что задачи выполняются

После добавления строки подождите минуту и проверьте storage/logs/laravel.log на записи о запуске задач. Для отладки можно временно заменить >> /dev/null 2>&1 на >> /var/www/example.com/storage/logs/cron.log 2>&1 и посмотреть, что выводит schedule:run. Не забудьте вернуть исходное перенаправление, когда всё заработает.

Где ошибаются, когда правят конфиг

  • Задание добавлено в crontab пользователя root, а сайт работает под www-data. Laravel не может писать в storage и кеш, задачи падают с ошибкой прав.

    Ставьте строку через sudo crontab -u www-data -e, чтобы cron работал от того же пользователя, что и PHP-FPM.

  • В строке остался путь /var/www/example.com, хотя проект лежит в другом каталоге. Cron каждую минуту завершается с ошибкой, задачи не выполняются.

    Замените путь на абсолютный путь к папке с artisan, проверьте его командой pwd из корня проекта.

  • Планировщик запускают вручную через php artisan schedule:run и ждут, что задачи будут выполняться по расписанию. Без cron команда срабатывает один раз.

    Добавьте строку crontab с * * * * *, чтобы schedule:run вызывался каждую минуту.

  • Вывод команды не перенаправлен, и cron шлёт письма на локальный ящик. Со временем это забивает диск или лог.

    Оставьте >> /dev/null 2>&1 в конце строки или направьте вывод в отдельный файл в storage/logs.

Deploykin

Как это делается в Deploykin

В Deploykin cron-задачи и демоны Supervisor создаются из панели: одиннадцать готовых расписаний или своё выражение, пресеты демонов для Horizon, очередей, планировщика и Reverb. Вывод задач пишется в лог и читается в панели.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Почему задачи Laravel не выполняются, хотя crontab добавлен?

Проверьте путь в строке и пользователя crontab. Затем запустите php artisan schedule:list из папки проекта: если список пуст, задачи не зарегистрированы в коде.

Можно ли запускать планировщик от root?

Можно, но тогда файлы в storage и bootstrap/cache могут получить владельца root, и сайт под www-data перестанет в них писать. Запускайте от пользователя сайта.

Как часто вызывать schedule:run?

Раз в минуту, как в строке * * * * *. Laravel сам определяет, какие задачи пора выполнять, и повторный вызов в ту же минуту ничего не ломает.

Где посмотреть, что именно запускает планировщик?

Команда php artisan schedule:list показывает задачи и время следующего запуска. Для истории выполнения смотрите storage/logs/laravel.log.

Ещё по теме

crontab: планировщик задач на сервере: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.