mb4it/bitrix-support

Helper library for 1C-Bitrix: ORM storage, migrations, EntityView, files, logging.

dev-master 2026-04-27 10:05 UTC

Requires

• php: ^8.2
• ext-fileinfo: *
• mb4it/collections: @dev
• mb4it/conditionable: @dev
• mb4it/container: @dev
• mb4it/filesystem: ^1.0
• mb4it/logger: @dev
• mb4it/stringable: @dev
• psr/log: ^1.0|^2.0|^3.0
• spatie/image: ^3.8

Requires (Dev)

• ext-pdo_sqlite: *
• avshatalov48/bitrix-core-business: @dev
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.0

MIT

• Maxim Bezvodinskikh

README

Composer library for 1C-Bitrix projects: ORM storage helpers (MySQL / PostgreSQL batch SQL), Highload blocks, migration utilities, EntityView, files/images, logging.

Requirements

• PHP ^8.2 (see composer.json)
• Bitrix with D7 ORM and relevant modules at runtime (main, and optionally highloadblock, ui, etc.)

Install

composer require mb4it/bitrix-support

Several internal mb4it/* packages are pinned @dev today; for public consumption, align versions per your registry policy.

Autoload

Composer maps:

• MB\Bitrix\ → src/

A small app() helper is registered from src/Support/helpers.php; it delegates to MB\Bitrix\Foundation\Application::getInstance() (you must bootstrap the application first).

Namespace policy

Prefix	Role	Semver
MB\Bitrix\	Primary public API (Storage, Module, Migration, Foundation, most Config types, etc.). Prefer use statements from this tree for new code.	Breaking changes follow semver for documented public entrypoints.

Single PSR‑4 root is intentional. See docs/SUPPORTED.md for subsystem support levels.

Documentation

• Documentation index
• Supported vs experimental API
• Application bootstrap
• Migrations
• Storage / Highload
• UI Components - Forms, fields, tabs, EntitySelector
• Laravel-style DI

Matrix (high level)

Layer	Notes
PHP	^8.2
Bitrix	D7 ORM assumed; not tested against non-D7 cores
DB	Batch helpers target MySQL (ROW in UPDATE … JOIN) and PostgreSQL (ON CONFLICT, VALUES updates). Confirm MariaDB behaviour in your version.

Development

composer validate
composer dump-autoload -o
composer test
composer phpstan