cloud-castle / orm
Фасад ORM CloudCastle над пакетами db-*.
Package info
pkg:composer/cloud-castle/orm
Requires
- php: >=8.1
- cloud-castle/collection: >=1.0
- cloud-castle/config: ^2.1
- cloud-castle/db-collection: ^1.0
- cloud-castle/db-factory: ^1.0
- cloud-castle/db-manager: ^1.1
- cloud-castle/db-migration: ^1.1
- cloud-castle/db-model: ^1.1
- cloud-castle/db-profiler: ^1.0
- cloud-castle/db-relation: ^1.0
- cloud-castle/db-seeder: ^1.0
- cloud-castle/di: ^1.0
- cloud-castle/event: *
- cloud-castle/provider: ^1.0
- cloud-castle/query-builder: *
- cloud-castle/queue: ^1.7
- cloud-castle/uuid: ^1.1
- psr/log: ^1.1 || ^2.0 || ^3.0
Requires (Dev)
- deptrac/deptrac: ^3.0 || ^4.0
- ergebnis/composer-normalize: ^2.45
- friendsofphp/php-cs-fixer: ^3.75
- icanhazstring/composer-unused: ^0.9
- illuminate/database: ^10.48
- infection/infection: ^0.29 || ^0.33
- php-parallel-lint/php-parallel-lint: ^1.4
- phpmd/phpmd: ^2.15
- phpstan/extension-installer: ^1.4
- phpstan/phpstan: ^1.12 || ^2.1
- phpstan/phpstan-deprecation-rules: ^1.2 || ^2.0
- phpstan/phpstan-phpunit: ^1.4 || ^2.0
- phpstan/phpstan-strict-rules: ^1.6 || ^2.0
- phpunit/phpunit: ^10.5 || ^11.5
- psalm/plugin-phpunit: ^0.19 || ^0.20
- rector/rector: ^1.2 || ^2.0
- roave/security-advisories: dev-latest
- squizlabs/php_codesniffer: ^3.12 || ^4.0
- vimeo/psalm: ^6.0
- webmozart/assert: ^1.11
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-15 20:08:13 UTC
README
🇷🇺 Русский · 🇬🇧 English · 🇩🇪 Deutsch · 🇫🇷 Français · 🇪🇸 Español · 🇮🇹 Italiano
CloudCastle Orm
Фасад ORM CloudCastle над пакетами
db-*: соединения, профилирование моделей, миграции, сидеры, жадная загрузка связей и transactional outbox с DI.
Установка
composer require cloud-castle/orm
Требуется PHP 8.1+.
Быстрый старт
<?php
use CloudCastle\Config\Config;
use CloudCastle\DB\Manager\ConnectionManager;
use CloudCastle\DB\Profiler\QueryProfiler;
use CloudCastle\DI\Container;
use CloudCastle\Orm\Orm;
use CloudCastle\Orm\OrmServiceProvider;
use CloudCastle\Orm\Outbox\OutboxMigrations;
use CloudCastle\Orm\Outbox\OutboxServiceProvider;
use CloudCastle\Provider\ProviderKernel;
use CloudCastle\Queue\Outbox\OutboxStoreInterface;
$config = new Config([
'app' => ['debug' => true],
'database' => [
'default' => 'default',
'driver' => 'pgsql',
'host' => '127.0.0.1',
'port' => 5432,
'database' => 'app',
'username' => 'app',
'password' => 'secret',
],
]);
$container = new Container();
$container->set(Config::class, static fn (): Config => $config);
$container->set(ConnectionManager::class, static fn (): ConnectionManager => new ConnectionManager($config));
$kernel = new ProviderKernel($container);
$kernel->register(new OrmServiceProvider());
$kernel->register(new OutboxServiceProvider());
$kernel->boot();
/** @var Orm $orm */
$orm = $container->get(Orm::class);
$orm->useProfiler(new QueryProfiler());
/** @var OutboxStoreInterface $outbox */
$outbox = $container->get(OutboxStoreInterface::class);
$migrations = OutboxMigrations::all($container);
$orm->migrator(new Psr\Log\NullLogger(), $migrations)->migrate();
Возможности
- Фасад
Orm—connections(),connection(),migrator(),seed(),eagerLoad/eagerLoadMany/eagerLoadRecursive,observe/useProfiler. - Transactional outbox —
OutboxModel,ModelOutboxStore, миграции create/rename,OutboxFactory,QueueOutbox,OutboxMigrations::all(). - DI —
OrmServiceProvider,OutboxServiceProvider,ModelBinder::bind(). - Стек cloud-castle — db-manager, db-model, db-relation, db-migration, db-seeder, db-profiler, queue — без Laravel/Symfony.
Коротко
Тонкий фасад над уже существующими db-*: wiring соединений, профилирования и
outbox в одном пакете. По функционалу (фасад + outbox + DI) шире Eloquent/Query Builder
на этой оси; по скорости INSERT+SELECT в sqlite — быстрее Eloquent; по памяти —
тяжелее (компромисс ради фасада и observe).
Сравнение с аналогами
Все таблицы ниже сгенерированы автоматически из честных сравнительных
тестов (benchmarks/compare.php) на ОДИНАКОВОЙ операции для всех аналогов,
PHP 8.3.36, без Xdebug.
1. Функциональность
| Возможность | 🏆 CloudCastle | Eloquent | db-model¹ | Illuminate QB | PDO¹ |
|---|---|---|---|---|---|
| Фасад connections/migrator/seed/eagerLoad | ✅ | ✅ | ❌ | ❌ | ❌ |
| Transactional outbox (модель + миграции + DI) | ✅ | ❌ | ❌ | ❌ | ❌ |
| Жадная загрузка связей (в т.ч. рекурсивная) | ✅ | ✅ | ❌ | ❌ | ❌ |
| Профилирование SQL через observe | ✅ | ✅ | ✅ | ❌ | ❌ |
| DI ServiceProvider (Orm + Outbox) | ✅ | ✅ | ❌ | ❌ | ❌ |
| Стек без фреймворка (только cloud-castle/*) | ✅ | ❌ | ✅ | ❌ | ✅ |
| Всего | 🏆 6 | 4 | 2 | 0 | 1 |
2. Безопасность и корректность
| Свойство | 🏆 CloudCastle | Eloquent | db-model¹ | Illuminate QB | PDO¹ |
|---|---|---|---|---|---|
| Параметризованные запросы (без конкатенации SQL) | ✅ | ✅ | ✅ | ✅ | ✅ |
| Защита рекурсии связей (лимит глубины) | ✅ | ❌ | ❌ | ❌ | ❌ |
| Изоляция соединений (нет глобального PDO по умолчанию) | ✅ | ❌ | ✅ | ❌ | ✅ |
| SECURITY.md + composer audit в CI | ✅ | ✅ | ✅ | ✅ | ❌ |
| Усечение ошибок outbox (без утечки длинных ПД в колонку) | ✅ | ❌ | ❌ | ❌ | ❌ |
| Всего | 🏆 5 | 2 | 3 | 2 | 2 |
3. Производительность
INSERT+SELECT по PK в sqlite, 3 000 раз (минимум из 3).
| Решение | Время (мс) | Итог |
|---|---|---|
| 🏆 CloudCastle | 3 751,1 | быстрейшее среди библиотек |
| PDO¹ | 5 855,5 | базовый уровень (не библиотека) |
| db-model¹ | 6 594,8 | базовый уровень (не библиотека) |
| Illuminate QB | 6 836,9 | аналог |
| Eloquent | 7 501,6 | аналог |
4. Потребление памяти
Фактически занятая память 1 500 удержанных результатов (изолированный процесс).
| Решение | Пиковая память (KB) | Итог |
|---|---|---|
| PDO¹ | 96 | базовый уровень (не библиотека) |
| db-model¹ | 1 733 | базовый уровень (не библиотека) |
| 🏆 Eloquent | 1 850 | легчайшее среди библиотек |
| Illuminate QB | 2 067 | аналог |
| CloudCastle | 3 139 | аналог |
¹ Базовый уровень (нативные вызовы/примитивы без полноты решения) показан для контекста и не претендует на победу среди библиотек-аналогов.
О памяти честно. Eloquent легче при удержании результатов той же операции. Память — допустимый компромисс ради функционала фасада/outbox и скорости. Минусы пакета кроме возраста/распространённости/памяти не закладываем.
Плюсы, минусы и когда применять
Сильные стороны:
- Фасад + transactional outbox + DI из коробки поверх
db-*. - Быстрее Eloquent на INSERT+SELECT (sqlite, честный бенч).
- Защита рекурсии связей и усечение ошибок outbox.
Слабые стороны (честно):
- Память — выше, чем у Eloquent на той же операции.
- Возраст и распространённость — моложе и меньше установок, чем Eloquent/Doctrine.
- Не заменяет Unit of Work / DQL Doctrine — это фасад стека CloudCastle, не полный аналог Doctrine ORM (ограничение скоупа, не минус качества).
Когда применять. Приложения на стеке cloud-castle (runtime, fr), где нужны
единый wiring ORM и transactional outbox. Для чистого Laravel удобнее Eloquent;
для богатого Unit of Work — Doctrine.
Разработка
composer install
composer check # линтеры + статический анализ + тесты
composer fix # автоисправления (Rector, PHP CS Fixer, PHPCBF)
composer ci # полный CI-пайплайн локально
composer docs:build # сравнение + таблицы в README/wiki
Полный список команд с описаниями: composer run-script --list.
Документация
- Wiki: wiki/docs/ru/Home.md
- Репозиторий: https://gitverse.ru/cloud-castle/orm
- История изменений: CHANGELOG.md
- Обновление: UPGRADING.md
- Поддержка: SUPPORT.md
- Как внести вклад: CONTRIBUTING.md
- Кодекс поведения: CODE_OF_CONDUCT.md
- Политика безопасности: SECURITY.md
Лицензия
MIT © CloudCastle (alex-4-17@yandex.ru)
🇷🇺 Русский · 🇬🇧 English · 🇩🇪 Deutsch · 🇫🇷 Français · 🇪🇸 Español · 🇮🇹 Italiano