bitrix-service-locator
Используй для DI Битрикса: ServiceLocator, services в .settings.php, привязки интерфейсов, фабрики и автосборка. Переопределение сервисов, контекст вызова и версия ядра.
How do I install this agent skill?
npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-service-locatorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides architectural guidance and documentation for using Dependency Injection and the Service Locator within the Bitrix framework. It follows secure practices for secret management and contains no malicious code, suspicious external references, or obfuscation.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
ServiceLocator и внедрение зависимостей
Baseline: main 23.0+ · Verified: main 26.1000.0
Перед PHP-кодом прочитай bitrix-framework, если ещё не читал его в этой задаче.
Границы DI задаёт bitrix-framework: сервисы и получатели Messenger поддерживают конструктор; контроллеры — параметры действий; CLI — конструктор Since main 26.900. Классы предметной области не обращаются к контейнеру.
Как разрешается get($id) (Since main 26.250*)
| Ключ | Результат |
|---|---|
Уже создан или передан в addInstance() | Тот же экземпляр |
| Не зарегистрирован, класс существует | Автосборка: параметр конструктора = get(<его тип>); при наличии значения по умолчанию берётся оно |
| Зарегистрирован интерфейс / абстрактный класс | className → реализация с автосборкой (constructorParams игнорируется); замыкание constructor вызывается с аргументами constructorParams |
| Зарегистрирован конкретный класс или строковый ID | className → new $class(...array_values(constructorParams)), без автосборки; замыкание constructor вызывается без аргументов |
- Экземпляры кешируются на время процесса, кроме записей с
'singleton' => false. - Цикл вызывает
CircularDependencyException. Нетипизированный, объединённый или скалярный параметр без значения по умолчанию вызываетServiceNotFoundException. - До 26.250 зарегистрированный ключ создаётся через
new $class(...constructorParams)илиconstructor(). Незарегистрированные классы собираются, только если все параметры конструктора — конкретные классы (без интерфейсов; значения по умолчанию игнорируются). Параметраsingletonнет. На таком ядре привязывай реализации с зависимостями через замыканиеconstructor.
Регистрация
Секция services в /local/modules/vendor.module/.settings.php регистрируется при Loader::includeModule(); также доступна в глобальных настройках:
<?php
return [
'services' => [
'value' => [
// интерфейс → реализация (автосборка с 26.250*)
\Vendor\Blog\Internals\Contract\Repository\PostRepositoryInterface::class => [
'className' => \Vendor\Blog\Internals\Repository\OrmPostRepository::class,
],
// скалярные аргументы → фабрика
\Vendor\Blog\Infrastructure\TelegramClient::class => [
'constructor' => static fn () => new \Vendor\Blog\Infrastructure\TelegramClient(
(string)getenv('TELEGRAM_BOT_TOKEN'),
),
],
// позиционные аргументы; замыкание вычисляется при первом get()
'vendor.blog.mailer' => [
'className' => \Vendor\Blog\Infrastructure\Mailer::class,
'constructorParams' => static fn () => ['noreply@example.com'],
],
],
'readonly' => true,
],
];
- Не регистрируй конкретный класс, которому нужны только другие классы.
get(PostService::class)соберёт зависимости, а один[ 'className' => PostService::class ]приведёт кnew PostService()→ArgumentCountError. - Для зависимости с интерфейсом типизируй параметр конструктора интерфейсом. В
servicesключ —Interface::class, реализация задаётся вclassNameили фабрикойconstructor. Для остальных ключей предпочитай FQCN. - Ядро регистрирует
Application,Routing\Router,DB\Connection,Data\Cache,Data\ManagedCache,Data\TaggedCache,EventManager,Data\ConnectionPool,\CUserTypeManager(Since main 26.250*) иData\Storage\PersistentStorageInterface(Since main 25.1100,bitrix-storage). Передавай их в конструктор вместо вызововApplication::getInstance()->….
Переопределения
- Побеждает первая регистрация:
registerByModuleSettings()пропускает существующие ключи. Последующий модуль не переопределяет предыдущий. - Для переопределения до загрузки модуля задай привязку в секции
servicesфайла/local/.settings_extra.php. Ядро заменяет секцию целиком. Сохрани остальные глобальные привязки (bitrix-settings). - Во время выполнения используй
addInstanceLazy()до первогоget(). Уже созданный экземпляр в локаторе заменяй черезaddInstance().
Получение сервисов
- Сервисы: параметры конструктора.
- Действия контроллеров: конкретный класс в типе параметра. Интерфейсы в параметрах действий не разрешаются (
bitrix-controllers). - Получатели Messenger создаются через
get(FQCN)с автосборкой. Команды CLI поддерживают её Since main 26.900; на старом ядре получай сервис вexecute(). Обработчики событий получают сервис внутри обработчика. has($id)возвращает true только для зарегистрированных или созданных ID, а не для любых классов, доступных автосборке.
Правила
- Сервисы — одиночки на время процесса: не храни в свойствах состояние запроса. Долгоживущие потребители сохраняют экземпляры между сообщениями.
- Не создавай
new Service()в контроллере/команде, если контейнер может его собрать. В предметной области вызовов контейнера нет. - Конфигурация передаётся типизированным объектом или скалярами через фабрику, а не сервисом с произвольным массивом.
- Флаги возможностей:
Bitrix\Main\Config\Feature(Since main 26.700,bitrix-storage), а не самодельный сервис флагов.
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-service-locator">View bitrix-service-locator on skillZs</a>