Настройка cron для агентов и обменов

В 1С-Битрикс регламентные фоновые задачи — агенты, отправка отложенной почты, служебные операции модулей и части обмена с 1С — по умолчанию запускаются «на хитах», то есть при заходах посетителей на сайт. Это работает, но ненадёжно: при низком трафике задачи откладываются, а на «невезучих» запросах пользователей повисает лишняя нагрузка. Перевод фоновых задач на cron делает их выполнение предсказуемым по расписанию и разгружает обычные запросы. Ниже — как это правильно настроить.

Зачем переводить агенты и обмены на cron

• Предсказуемость. Задачи выполняются строго по расписанию, а не «когда зайдёт посетитель».
• Скорость сайта. Фоновая работа снимается с обычных хитов — страницы отдаются быстрее.
• Надёжность почты. Очередь писем разбирается вовремя, даже ночью при нулевом трафике.
• Стабильный обмен. Служебные агенты обмена с 1С отрабатывают регулярно, не завися от посещаемости.

Настройку и обслуживание фоновых задач берёт на себя администрирование 1С-Битрикс, а корректность самих обменов — поддержка обмена с 1С (товары, заказы, остатки, цены).

Что понадобится

• Доступ по SSH к серверу и права на редактирование crontab (обычно от пользователя, под которым работает сайт).
• Путь к исполняемому PHP CLI (например, /usr/bin/php).
• Абсолютный путь к скрипту агентов /bitrix/modules/main/tools/cron_events.php.
• Права администратора в админке — чтобы поменять режим запуска агентов.

Шаг 1. Включаем поддержку cron в dbconn.php

Откройте файл /bitrix/php_interface/dbconn.php и добавьте константу, которая разрешает запуск агентов из командной строки:

• Определите define("BX_CRONTAB_SUPPORT", true);
• При запуске из cron платформа сама выставляет служебный признак BX_CRONTAB, поэтому агенты понимают, что их вызвали по расписанию, а не на хите.

Шаг 2. Отключаем выполнение агентов «на хитах»

1. Зайдите в админку: Настройки → Настройки продукта → Настройки модулей → Главный модуль.
2. Найдите блок настроек агентов и снимите режим «Проверять активность агентов и отправку почты на хитах».
3. Включите режим запуска агентов на cron.
4. Сохраните изменения.

После этого система перестанет нагружать посетителей фоновыми задачами и будет ждать запуска по расписанию — который мы настроим на следующем шаге.

Шаг 3. Добавляем задание в crontab

Отредактируйте crontab пользователя сайта (crontab -e) и добавьте задание, которое раз в минуту запускает агентский скрипт:

Часть задания	Что означает
* * * * *	Расписание — каждую минуту.
/usr/bin/php	Путь к интерпретатору PHP CLI (уточните на своём сервере).
-f /путь/к/сайту/bitrix/modules/main/tools/cron_events.php	Скрипт, который выполняет «просроченные» агенты и очередь почты.

Строка целиком выглядит примерно так: * * * * * /usr/bin/php -f /home/site/public_html/bitrix/modules/main/tools/cron_events.php. Пути обязательно указывайте абсолютными.

Обмен с 1С и тяжёлые регламентные задачи

Минутный запуск cron_events.php закрывает почту и лёгкие агенты. Тяжёлые операции лучше выносить в отдельные задания crontab, чтобы они не растягивали минутный цикл:

• Полный обмен с 1С и переиндексацию поиска ставят отдельными заданиями с более редким расписанием (например, ночью).
• Инициатором обмена часто выступает сама 1С по своему расписанию, а Битрикс обрабатывает очередь служебными агентами — держите их на cron, чтобы заказы, остатки и цены синхронизировались вовремя.
• Если обмен «застревает» или дублирует данные, разобраться поможет поддержка обмена с 1С.

Как проверить, что cron работает

1. В админке в списке агентов посмотрите время последнего и следующего запуска — оно должно обновляться по расписанию.
2. Отправьте тестовое письмо (или инициируйте событие с почтой) и убедитесь, что оно уходит без ожидания посетителя.
3. Проверьте лог cron на сервере — задание должно исполняться каждую минуту без ошибок.
4. Убедитесь, что скрипт запускается именно через PHP CLI, а не как веб-запрос.

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

• Не включена константа поддержки cron. Забыли BX_CRONTAB_SUPPORT в dbconn.php — агенты продолжают работать «на хитах».
• Неверный путь к PHP или скрипту. Задание в crontab не запускается; проверьте абсолютные пути и наличие php-cli.
• Задание от чужого пользователя. Нет прав на файлы сайта — ошибки записи в кеш и логи.
• Режим «на хитах» не отключён в админке. Настроили crontab, но забыли переключить режим агентов — эффект неполный.
• Тяжёлый обмен в минутном задании. Долгая операция перекрывает следующий запуск — выносите её в отдельное расписание.

Итог

Перевод агентов и фоновых частей обмена на cron — три связанных действия: включить BX_CRONTAB_SUPPORT в dbconn.php, отключить режим «на хитах» в настройках главного модуля и добавить в crontab минутный запуск cron_events.php. Тяжёлые задачи выносятся отдельными заданиями. В результате почта и служебные агенты работают по расписанию, сайт не тратит ресурсы посетителей на фоновую работу, а обмен с 1С идёт стабильно. Настройку и последующий контроль удобно передать на техническую поддержку 1С-Битрикс.