Как перенести агенты 1С-Битрикс на cron
Когда нужен cron, как включить его через BitrixEnv и проверить, что агенты и почтовые события выполняются регулярно.
Время чтения: 10 мин.
Уровень: Продвинутый
Системные требования
Нужны административные права в продукте, SSH-доступ и резервная копия. На BitrixEnv используйте штатный мастер cron, а не создавайте параллельное расписание вручную.
Смотреть системные требования1. Когда переносить агенты на cron
По умолчанию проверка агентов может происходить во время открытия страниц. На проекте с неравномерным трафиком это даёт задержки и непредсказуемое время запуска.
Cron полезен для регулярных фоновых задач, почтовой очереди и тяжёлых агентов. Сначала откройте Настройки → Настройки продукта → Агенты, найдите долгие и просроченные задания и зафиксируйте текущее состояние.
Штатный скрипт cron_events.php
Скрипт уже входит в продукт и находится в bitrix/modules/main/tools/cron_events.php.
2. Настройте cron через BitrixEnv
На сервере с BitrixEnv откройте /root/menu.sh, выберите управление сайтами и операцию изменения cron-задач нужного сайта. Мастер создаёт файл расписания с корректными путями для выбранного сайта.
Для сайта по умолчанию расписание может находиться в /etc/crontab, для сайтов из пула — в файле вида /etc/cron.d/bx_имяБД. Не копируйте путь от другого проекта без проверки.
Совет
Два одновременно настроенных механизма запуска могут дать дублирование задач. Перед изменением выясните, выполняются агенты на хитах, через системный cron или через настройки BitrixEnv.
3. Поймите команду запуска
Типовой вызов из официальной документации использует штатный скрипт:
/usr/bin/php -f /home/bitrix/www/bitrix/modules/main/tools/cron_events.phpИнтервал выбирают по требованиям проекта; распространённый диапазон — от одной до пяти минут. В многосайтовой установке путь к корню каждого сайта отличается.
4. Проверьте пользователя и PHP
Задание должно выполняться от пользователя с доступом к файлам сайта. В BitrixEnv это обычно bitrix. Проверьте версию CLI PHP:
php -v
php --iniЕсли CLI PHP отличается от версии веб-сервера, агент может завершаться ошибкой из-за расширений или настроек. Исправляйте путь в расписании, а не подменяйте системный PHP без проверки BitrixEnv.
5. Проверьте результат и очередь почты
После включения cron подождите несколько интервалов и проверьте время последнего запуска агентов, очередь почтовых событий и журнал ошибок cron.
Создайте контролируемое тестовое событие: письмо, уведомление или безопасный агент. Оно должно выполниться один раз и в ожидаемое время.
Официальное описание механизма агентов и инструкция запуска из cron.
Была ли эта статья полезной?
Спасибо за ваш отзыв!
