Cron для планировщика Laravel: настройка и проверка
Планировщик Laravel запускается одной строкой в crontab: каждую минуту вызывается php artisan schedule:run, а Laravel сам решает, какие задачи выполнить. Добавьте эту строку пользователю, от которого работает сайт, и проверьте, что задания появляются в расписании.
Конфиг
* * * * * cd /var/www/example.com && php artisan schedule:run >> /dev/null 2>&1
Что заменить под свой сервер
/var/www/example.com- папка проекта
Как применить и проверить
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.
Ещё по теме
- Конфиг · Cron Crontab: примеры расписаний и как их применить Готовый crontab с примерами расписаний: каждые 5 минут, каждый час, по будням, @reboot. Как применить через crontab -e и проверить по /var/log/syslog.
- Конфиг · Cron Supervisor для очередей Laravel: конфиг воркера Готовый конфиг Supervisor для очередей Laravel: разбор каждой строки, замена пути, пользователя и numprocs, установка, reread, update и проверка статуса воркеров.
- Руководство · Cron crontab guru: как читать формат crontab и настроить задание Разбираем формат crontab по полям, показываем команды crontab -e и crontab -l, проверку через syslog и типичные ошибки при настройке cron на Ubuntu 24.04.
- Руководство · Cron Настройка cron для Bitrix на Ubuntu 24.04 Как настроить cron для Bitrix на Ubuntu 24.04: таблица пользователя www-data, запуск агентов и почтовой очереди, полные пути, логи и проверка выполнения.
- Руководство · Cron Как настроить cron каждые 5 минут на Ubuntu 24.04 Как настроить задание cron каждые 5 минут на Ubuntu 24.04: строка crontab, полные пути, логирование вывода и проверка запусков по syslog.
- Руководство · Cron Настройка crontab на Ubuntu 24.04: от расписания до проверки Пошаговая настройка crontab на Ubuntu 24.04: синтаксис расписания, запуск скрипта каждый час, права www-data, проверка через syslog и типичные ошибки.