bitrix-background-jobs
Используй для отложенной работы Битрикса: агенты CAgent, cron, Application::addBackgroundJob после ответа и очереди Messenger (messenger:consume). Выбор механизма, повторы и ошибки.
How do I install this agent skill?
npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-background-jobsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides comprehensive technical documentation for managing background tasks within the Bitrix framework, including agents, background jobs, and message queues. It includes specific security recommendations for avoiding dynamic execution risks in legacy systems and correctly configuring system-level task runners like cron.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Фоновые задания
Baseline: main 23.0+ · Verified: main 26.1000.0
Перед PHP-кодом прочитай bitrix-framework, если ещё не читал его в этой задаче.
В таблице выбери только нужный rules/*.md; пути относительны каталогу скилла.
| Задача | Читать |
|---|---|
| Периодическое или отложенное задание, агенты на cron, долгие агенты | rules/agents.md |
| Короткая работа после ответа | rules/background-job.md |
| Очередь: сообщение, получатель, отправка, повторы | rules/messenger.md |
Настройки очередей, брокеры, messenger:consume, очереди ядра | rules/messenger-config.md |
Выбор: расписание → агент на cron; несколько секунд после ответа → addBackgroundJob; повторы, объём, параллельные исполнители → Messenger (Since main 25.100.300, альфа); разовая долгая миграция → консольная команда (bitrix-console-commands).
Обязательные правила
- Фоновый код не имеет контекста пользователя: агенты и получатели устанавливают
global $USER = null; не используй$_SESSION/cookies. Передавай ID пользователя/сайта явно. - На хитах агенты, Messenger в режиме
webиaddBackgroundJob()выполняются после отправки ответа,OnAfterEpilogиsession_write_close(), с пулом БД, переключённым на master. - Код задания только получает сервис через
ServiceLocator::getInstance()->get()и вызывает его (DI конструктора агента недоступен —bitrix-framework). - Задания должны быть идемпотентными: агент может запуститься параллельно дважды, сообщение может прийти повторно.
- Ошибки записывай через PSR-3 (
bitrix-logger); свои агенты удаляй при удалении модуля.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/bxmaximum/bitrix-framework-skills/bitrix-background-jobs">View bitrix-background-jobs on skillZs</a>