Запуск скриптов по расписанию в BitrixVM через crontab.cfg

Запуск скриптов по расписанию в BitrixVM через crontab.cfg
Metatag DigitalАвторMetatag Digital2 мин

Любой разработчик сталкивается с задачами, которые требуют автоматического и регулярного выполнения. Среди типичных примеров:

  • Пакетное обновление остатков и цен из файлов поставщиков.
  • Массовый импорт товарных позиций из внешних систем (1С, CRM, маркетплейсы).
  • Фоновая обработка данных и пересчет по сложным формулам.
  • Автоматическая категоризация товаров и простановка бейджей.

Обычно для этого пишется скрипт, но его нужно не просто запустить, а поручить это системе. И здесь на помощь приходит планировщик заданий cron. Если на виртуальном хостинге задачи добавляются через панель управления, то в среде BitrixVM есть свой элегантный способ.

Содержание

Классический способ и его альтернатива

Конечно, вы можете отредактировать системный crontab вручную, используя консольные редакторы vim или nano. Однако существует более структурированный и менее подверженный ошибкам метод, который идеально вписывается в концепцию BitrixVM.

Пошаговая инструкция: Настройка планировщика

Вместо прямого редактирования системного файла, BitrixVM предлагает использовать централизованный конфигурационный файл.

  1. Найдите или создайте файл конфигурации.
    Перейдите в папку вашего сайта по пути /bitrix/crontab/. Если в ней отсутствует файл crontab.cfg — создайте его.
  2. Добавьте ваши задачи.
    Внесите все необходимые cron-задачи в этот файл, соблюдая стандартный синтаксис. Каждая строка — это отдельное задание.
  3. Примените конфигурацию.
    После сохранения файла откройте терминал и выполните команду, указав полный путь к вашему файлу:
    Bash
    crontab /home/bitrix/ext_www/your_site_name/bitrix/crontab/crontab.cfg -u bitrix

    Важное примечание: Ключ -u bitrix обязателен, если вы работаете из-под пользователя root. Он гарантирует, что задачи будут добавлены от имени пользователя bitrix, что критически важно для корректной работы с правами доступа.

  4. Проверка.
    Убедиться, что задачи успешно добавлены, можно с помощью команды просмотра списка:
    Bash
    crontab -l -u bitrix

Ключевые особенности и ограничения метода

  • Одно ядро — один файл. Данный способ идеален для серверов с одной установкой Битрикс. Если у вас запущено несколько независимых сайтов (несколько ядер), у каждого будет свой crontab.cfg. Применение файла одного сайта перезапишет задачи другого. Для мультисайтовой среды рекомендуется использовать прямое редактирование системного crontab.

  • Права пользователя. Все задачи должны выполняться от пользователя bitrix. Команда с ключом -u bitrix решает эту проблему.
  • Централизация конфигурации. Этот метод перезаписывает весь crontab пользователя bitrix содержимым файла crontab.cfg. Если у вас ранее были задачи, добавленные вручную, их необходимо перенести в этот файл, иначе они будут утеряны.

Технический нюанс: DOCUMENT_ROOT

В среде cron переменная $_SERVER["DOCUMENT_ROOT"] не определена. Если ваш скрипт использует её (а так обычно делают скрипты для Битрикс), её необходимо задать явно в самом коде.

Пример корректного подключения ядра для скрипта, запускаемого из cron:

PHP
<?php
define("NO_AGENT_CHECK", true);
define("NO_KEEP_STATISTIC", true);
define("NOT_CHECK_PERMISSIONS", true);
// Явно прописываем путь к корневой директории сайта
$_SERVER["DOCUMENT_ROOT"] = "/home/bitrix/ext_www/your_site_name";
// Подключаем пролог
require_once($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php");
// ... Ваш код ...
// Эпилог можно не подключать, если после вашего кода не идет вывод HTML.
?>

Этот подход позволяет удобно и безопасно управлять периодическими задачами, храня их конфигурацию в файле проекта, а не в глубинах системных настроек сервера.

Может быть интересно

Назад к списку

Позвонить