PHPackages kosmosafive/bitrix-db - 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. [Database & ORM](/categories/database) 4. / 5. kosmosafive/bitrix-db ActiveLibrary[Database & ORM](/categories/database) kosmosafive/bitrix-db ===================== Bitrix Database 2.3.0(4mo ago)087MITPHPPHP >=8.4 Since Jul 21Pushed 4mo agoCompare [ Source](https://github.com/kosmosafive/bitrix-db)[ Packagist](https://packagist.org/packages/kosmosafive/bitrix-db)[ Docs](https://github.com/kosmosafive/bitrix-db)[ RSS](/packages/kosmosafive-bitrix-db/feed)WikiDiscussions master Synced today READMEChangelogDependencies (6)Versions (9)Used By (0) Bitrix Database =============== [](#bitrix-database) Расширение соединения с базой данных Bitrix (MysqliConnection). Конфигурация ------------ [](#конфигурация) Конфигурацию указывать в файле /bitrix/.settings.php или /bitrix/.settings\_extra.php. ``` $vendorAutoload = dirname(__DIR__) . '/local/vendor/autoload.php'; if (file_exists($vendorAutoload)) { require_once $vendorAutoload; } // ... 'connections' => [ 'value' => [ 'default' => [ 'className' => '\\Kosmosafive\\Bitrix\\DB\\MysqliConnection', // ... ``` Использование ------------- [](#использование) В качества класса DataManager используется `Kosmosafive\Bitrix\DB\ORM\Data\DataManager`. ### Генерация запросов для пакетных операций с данными [](#генерация-запросов-для-пакетных-операций-с-данными) Перед генерацией запросов может потребоваться предварительно загрузить карту таблицы. ``` SampleTable::getMap(); ``` ### Индексы [](#индексы) В классе, описывающем таблицу (наследник `Kosmosafive\Bitrix\DB\ORM\Data\DataManager`), необходимо реализовать интерфейс `Kosmosafive\Bitrix\DB\ORM\Index\IndexInterface`. ``` public static function getIndexConfigurationCollection(): ConfigurationCollection { return new ConfigurationCollection(static::class) ->add(['ENTITY_TYPE']) ->add(['ENTITY_TYPE', 'SECTION_ID']); } ``` Порядок полей в индексе **важен**. Создать индекс (вызывается в createDbTable()): ``` $entity = SampleTable::getEntity(); $entity->createAdditionalIndexes(); ``` ### Связи [](#связи) Связи формируются после создания таблиц. Удаляются перед удалением таблиц. Связи вычисляются автоматически относительно полей типа `\Bitrix\Main\ORM\Fields\Relations\Reference`. Для создания связей выполнить: ``` $entity = SampleTable::getEntity(); $entity->createForeignKeys(); ``` Для удаления связей выполнить: ``` $entity = SampleTable::getEntity(); $entity->dropForeignKeys(); ``` ### Ограничения [](#ограничения) В классе, описывающем таблицу (наследник `Kosmosafive\Bitrix\DB\ORM\Data\DataManager`), необходимо реализовать интерфейс `Kosmosafive\Bitrix\DB\ORM\Constraint\ConstraintableInterface`. ``` public static function getConstraintCollection(): ConstraintCollection { return new ConstraintCollection() ->add(new Unique('user_entity', 'USER_ID', 'ENTITY_ID')); } ``` Создать ограничения (вызывается в createDbTable()): ``` $entity = SampleTable::getEntity(); $entity->createConstraints(); ``` #### Check [](#check) `Kosmosafive\Bitrix\DB\ORM\Constraint\Check` Проверка переданного условия. ``` new Chech( 'price', 'PRICE > 0' ); ``` #### Unique [](#unique) `Kosmosafive\Bitrix\DB\ORM\Constraint\Unique` Проверка уникальности одного или нескольких полей. ``` new Unique( 'user_entity', 'USER_ID', 'ENTITY_ID' ); ``` ### Поля [](#поля) Для маппинга кастомных полей в классе, описывающем таблицу (наследник `Kosmosafive\Bitrix\DB\ORM\Data\DataManager`), необходимо модифицировать метод `getMap()`. ``` public static function getMap(): array { $map = [...]; static::addTableMapping($map); return $map; } ``` #### Boolean [](#boolean) `Kosmosafive\Bitrix\DB\ORM\Fields\BooleanField` Поле, хранящее булево значение. Без возможности указания замещающего значения для true \\ false. #### Char [](#char) `Kosmosafive\Bitrix\DB\ORM\Fields\CharField` Строка с фиксированной длиной. #### Datetime [](#datetime) `Kosmosafive\Bitrix\DB\ORM\Fields\DatetimeField` Поле, хранящее дату и время. Может хранить миллисекунды (size = 6). #### Unsigned Integer [](#unsigned-integer) `Kosmosafive\Bitrix\DB\ORM\Fields\UnsignedIntegerField` Беззнаковое целое. #### Uuid [](#uuid) `Kosmosafive\Bitrix\DB\ORM\Fields\UuidField` Поле, хранящее uuid. Можно использовать в качестве идентификатора. Перед фильтрацией по значению поля необходимо подготовить данные: ``` use Ramsey\Uuid\Uuid; $uuid = Uuid::fromString($value)->getBytes(); SampleTable::query() ->where('ID', $uuid); ``` #### Decimal [](#decimal) `Kosmosafive\Bitrix\DB\ORM\Fields\DecimalField` Точное числовое значение. В отличие от оригинального поля не приводит к float. Миграция -------- [](#миграция) - [Миграция с 1.x на 2.0](doc/migration/2.0.md) ### Health Score 41 — FairBetter than 87% of packages Maintenance78 Regular maintenance activity Popularity9 Limited adoption so far Community6 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~37 days Recently: every ~30 days Total 7 Last Release 120d ago Major Versions 1.0.0 → 2.0.02025-08-22 ### Community Maintainers ![](https://www.gravatar.com/avatar/4149bcfcdcc947ad42afa006615812c8ea743bf76e0e10ef44ffb3d5ae2796f0?d=identicon)[kosmosafive](/maintainers/kosmosafive) --- Top Contributors [![kosmosafive](https://avatars.githubusercontent.com/u/14090839?v=4)](https://github.com/kosmosafive "kosmosafive (37 commits)") --- Tags datadatabaseormbitrixmanagerdbConnectionmysqli ### Code Quality Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/kosmosafive-bitrix-db/health.svg) ``` [![Health](https://phpackages.com/badges/kosmosafive-bitrix-db/health.svg)](https://phpackages.com/packages/kosmosafive-bitrix-db) ``` ### Alternatives [stefangabos/zebra_database An advanced, compact and lightweight MySQL database wrapper library, built around PHP's MySQLi extension. 11712.6k](/packages/stefangabos-zebra-database)[smrtr/mysql-version-control A crude version control system for mysql written in php 221.4k](/packages/smrtr-mysql-version-control) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)