PHPackages                             webarchitect609/bitrix-neverinclude - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. webarchitect609/bitrix-neverinclude

ActiveLibrary[Utility & Helpers](/categories/utility)

webarchitect609/bitrix-neverinclude
===================================

Automatic Bitrix modules loader helps you to forget about CModule::IncludeModule and Loader::includeModule.

v1.1.2(1y ago)1115.1k4[1 PRs](https://github.com/webarchitect609/bitrix-neverinclude/pulls)MITPHPPHP ^7.2 || ^8.0

Since Apr 22Pushed 1y ago3 watchersCompare

[ Source](https://github.com/webarchitect609/bitrix-neverinclude)[ Packagist](https://packagist.org/packages/webarchitect609/bitrix-neverinclude)[ Docs](https://github.com/webarchitect609/bitrix-neverinclude)[ RSS](/packages/webarchitect609-bitrix-neverinclude/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (11)Used By (0)

Автозагрузчик модулей Битрикс, который поможет вам забыть про вызовы CModule::IncludeModule и Loader::includeModule

Как использовать
----------------

[](#как-использовать)

1 Установите через composer:

`composer require webarchitect609/bitrix-neverinclude`

2 Если необходимо, то в init.php укажите список модулей, которые следует исключить из обработки данного автолоадера:

`\WebArch\BitrixNeverInclude\BitrixNeverInclude::addExcludedModules(['foo.bar',]);`

Данный пакет совместим с новыми версиями [andreyryabin/sprint.migration](https://packagist.org/packages/andreyryabin/sprint.migration): >=3.0

3 В `init.php` после подключения `vendor/autoload.php` добавьте вызов:

`\WebArch\BitrixNeverInclude\BitrixNeverInclude::registerModuleAutoload();`

**Больше подключать модули не нужно, за исключением некоторых ситуаций, описанных ниже.**

Особенности реализации
----------------------

[](#особенности-реализации)

1 Классы не из глобального namespace разбираются динамически и превращаются в название модуля, который тут же подключается.

2 Классы из глобальной области проверяются по маппингу "имя класса => имя модуля", для вычисления которого делается подключение всех установленных в системе модулей и производится сбор внутренних данных, которые потом кешируются.

Известные ограничения
---------------------

[](#известные-ограничения)

### При установке нового модуля

[](#при-установке-нового-модуля)

Если происходит установка нового модуля, использующего классы в глобальной области, кеш маппинга "имя класса => имя модуля" будет неактуальным. Рекомендуется сбросить его по тегу следующим образом:

```

$tagCache = \Bitrix\Main\Application::getInstance()->getTaggedCache();
$tagCache->clearByTag(\WebArch\BitrixNeverInclude\BitrixNeverInclude::CACHE_TAG);

```

После сброса кеша рекомендуется вызвать

`\WebArch\BitrixNeverInclude\BitrixNeverInclude::getClassMapping();`

, чтобы при следующем хите уже существовал маппинг "имя класса => имя модуля".

### Функции в модулях

[](#функции-в-модулях)

В некоторых модулях объявляются функции, которые недоступны без подключения модуля. Например, [функция `SaleFormatCurrency`](https://dev.1c-bitrix.ru/api_help/sale/functions/saleformatcurrency.php) недоступна без подключения [модуля `sale`](https://dev.1c-bitrix.ru/api_help/sale/index.php). Из-за того, что в php нет механизма автозагрузки функций, эта проблема не может быть решена автоматически. Следует вручную подключать соответствующий модуль перед вызовом функции, объявленной в этом модуле.

### Несовместимость с некоторыми модулями

[](#несовместимость-с-некоторыми-модулями)

Если архитектура модуля Битрикс сделана таким образом, что в `include.php` происходит регистрация своего автозагрузчика классов, то очень вероятна несовместимость такого модуля с данным пакетом. Следует исключить этот модуль из обработки(см. выше) и подключать его по необходимости вручную.

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 94.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~292 days

Recently: every ~619 days

Total

10

Last Release

678d ago

Major Versions

v0.4.2 → v1.0.02018-04-04

PHP version history (4 changes)v0.1.1PHP >=5.3.0

v0.2.0PHP >=5.5.0

v1.1.0PHP ^7.0

v1.1.2PHP ^7.2 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/9f9a6e3ee8c76415a66949c630cd1281bfb6a232a5648b2410574fb6e1e09b65?d=identicon)[webarchitect609](/maintainers/webarchitect609)

---

Top Contributors

[![webarchitect609](https://avatars.githubusercontent.com/u/11293610?v=4)](https://github.com/webarchitect609 "webarchitect609 (18 commits)")[![geff21st](https://avatars.githubusercontent.com/u/8845118?v=4)](https://github.com/geff21st "geff21st (1 commits)")

---

Tags

bitrixbitrix-modulecomposercomposer-libraryincludemodulephpbitrixautoloadingmodule

### Embed Badge

![Health badge](/badges/webarchitect609-bitrix-neverinclude/health.svg)

```
[![Health](https://phpackages.com/badges/webarchitect609-bitrix-neverinclude/health.svg)](https://phpackages.com/packages/webarchitect609-bitrix-neverinclude)
```

###  Alternatives

[bitrix-expert/bbc-module

Module with classes for the basis components

1951.8k1](/packages/bitrix-expert-bbc-module)[webarchitect609/bitrix-user-type

Set of custom Bitrix user property types and basic auxiliary functionality to help develop new types as easy and fast as it possible.

1418.4k1](/packages/webarchitect609-bitrix-user-type)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)