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

Настройка cron для Bitrix на Ubuntu 24.04

Задачи Bitrix запускаются системным cron от имени пользователя сайта. Настройка сводится к одной строке в таблице www-data с полным путём к PHP и скрипту bitrix/modules/main/tools/cron_events.php. После сохранения проверьте запуск по логу cron и по времени изменения файлов.

Руководство Cron 3 мин чтения

01Проверьте, что cron установлен и работает

На Ubuntu 24.04 cron установлен по умолчанию. Убедитесь, что служба активна: команда systemctl status cron должна показать active (running). Если пакета нет, установите его одной командой sudo apt install cron и запустите службу.

bash
systemctl status cron

02Определите пользователя сайта и путь к PHP

Файлы Bitrix должны принадлежать тому пользователю, от имени которого работает cron. Для nginx с PHP-FPM это обычно www-data. Проверьте владельца каталога сайта и путь к интерпретатору: в cron нельзя полагаться на PATH, поэтому нужен полный путь, например /usr/bin/php.

bash
ls -ld /var/www/example.com
command -v php
sudo -u www-data php -v

03Откройте таблицу crontab пользователя www-data

Таблицу текущего пользователя правит crontab -e, таблицу www-data, sudo crontab -u www-data -e. Файлы лежат в /var/spool/cron/crontabs/, руками их не редактируют. Выберите редактор, если система спросит, и добавьте строку расписания.

bash
sudo crontab -u www-data -e

04Добавьте строку запуска агентов Bitrix

Агенты и почтовая очередь Bitrix обрабатываются скриптом bitrix/modules/main/tools/cron_events.php из корня сайта. Запускайте его каждую минуту от имени www-data, с полным путём к PHP и с перенаправлением вывода в лог: без почтового сервера вывод иначе теряется. Символ % в команде экранируйте как \%.

text
* * * * * cd /var/www/example.com && /usr/bin/php -f bitrix/modules/main/tools/cron_events.php >> /var/log/bitrix-cron.log 2>&1

05Проверьте синтаксис и содержимое таблицы

После сохранения выведите таблицу командой sudo crontab -u www-data -l: строка должна быть на месте, без лишних пробелов и с полным путём. Ошибка в расписании не мешает сохранению, поэтому проверяйте именно вывод.

bash
sudo crontab -u www-data -l

06Убедитесь, что задача выполняется

Подождите минуту и посмотрите записи cron в системном журнале: grep CRON /var/log/syslog или journalctl -u cron. Затем проверьте лог, куда перенаправлен вывод скрипта, и время изменения файлов в bitrix/managed_cache или в каталоге агентов. Если запись в журнале есть, а лог пуст, скрипт завершился без вывода: проверьте код возврата и права на запись.

bash
grep CRON /var/log/syslog
sudo tail -n 50 /var/log/bitrix-cron.log
ls -l /var/www/example.com/bitrix/managed_cache

Частые ошибки

  • В crontab указан php без пути, и задача не выполняется: у cron окружение с PATH=/usr/bin:/bin, а нужный интерпретатор может лежать в другом каталоге.

    Пропишите полный путь, например /usr/bin/php, и проверьте его командой command -v php.

  • Строка добавлена в таблицу root, а файлы сайта принадлежат www-data. Скрипт падает на правах записи в bitrix/managed_cache.

    Правьте таблицу владельца файлов: sudo crontab -u www-data -e, а старую строку из root удалите.

  • Вывод скрипта не перенаправлен, и при отсутствии почтового сервера ошибки Bitrix не видны.

    Допишите в конец команды >> /var/log/bitrix-cron.log 2>&1 и проверяйте этот файл после запуска.

  • После смены часового пояса задачи срабатывают не в то время.

    После sudo timedatectl set-timezone перезапустите службу: sudo systemctl restart cron.

Deploykin

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

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

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

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

От какого пользователя запускать cron для Bitrix?

От владельца файлов сайта, обычно www-data. Тогда скрипт сможет писать в bitrix/managed_cache и другие каталоги без смены прав.

Какую команду прописать в crontab?

cd /var/www/example.com && /usr/bin/php -f bitrix/modules/main/tools/cron_events.php >> /var/log/bitrix-cron.log 2>&1. Расписание * * * * * запускает её каждую минуту.

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

У cron другое окружение и PATH, поэтому нужны полные пути. Также проверьте права пользователя таблицы, экранирование % и наличие перевода строки в конце файла.

Где смотреть результат работы cron для Bitrix?

Запуски видны в grep CRON /var/log/syslog или journalctl -u cron, а вывод скрипта, в файле, указанном после >>.

Ещё по теме

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

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