Search by

Фасад ORM CloudCastle над пакетами db-*.

1.7.0 2026-11-15 19:59 UTC

README

🇷🇺 Русский · 🇬🇧 English · 🇩🇪 Deutsch · 🇫🇷 Français · 🇪🇸 Español · 🇮🇹 Italiano

CloudCastle Orm

CloudCastle Orm

Packagist Version Downloads PHP Version License Packagist Stars Packagist Dependents Packagist Suggesters Packagist Advisories

GitVerse Issues Release

PHPStan Psalm PHPMD PHPCS Coverage Infection MSI OpenSSF Scorecard

Фасад 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. Функциональность

Возможность🏆 CloudCastleEloquentdb-model¹Illuminate QBPDO¹
Фасад connections/migrator/seed/eagerLoad✅✅❌❌❌
Transactional outbox (модель + миграции + DI)✅❌❌❌❌
Жадная загрузка связей (в т.ч. рекурсивная)✅✅❌❌❌
Профилирование SQL через observe✅✅✅❌❌
DI ServiceProvider (Orm + Outbox)✅✅❌❌❌
Стек без фреймворка (только cloud-castle/*)✅❌✅❌✅
Всего🏆 64201

2. Безопасность и корректность

Свойство🏆 CloudCastleEloquentdb-model¹Illuminate QBPDO¹
Параметризованные запросы (без конкатенации SQL)✅✅✅✅✅
Защита рекурсии связей (лимит глубины)✅❌❌❌❌
Изоляция соединений (нет глобального PDO по умолчанию)✅❌✅❌✅
SECURITY.md + composer audit в CI✅✅✅✅❌
Усечение ошибок outbox (без утечки длинных ПД в колонку)✅❌❌❌❌
Всего🏆 52322

3. Производительность

INSERT+SELECT по PK в sqlite, 3 000 раз (минимум из 3).

РешениеВремя (мс)Итог
🏆 CloudCastle3 751,1быстрейшее среди библиотек
PDO¹5 855,5базовый уровень (не библиотека)
db-model¹6 594,8базовый уровень (не библиотека)
Illuminate QB6 836,9аналог
Eloquent7 501,6аналог

4. Потребление памяти

Фактически занятая память 1 500 удержанных результатов (изолированный процесс).

РешениеПиковая память (KB)Итог
PDO¹96базовый уровень (не библиотека)
db-model¹1 733базовый уровень (не библиотека)
🏆 Eloquent1 850легчайшее среди библиотек
Illuminate QB2 067аналог
CloudCastle3 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.

Документация

Лицензия

MIT © CloudCastle (alex-4-17@yandex.ru)

🇷🇺 Русский · 🇬🇧 English · 🇩🇪 Deutsch · 🇫🇷 Français · 🇪🇸 Español · 🇮🇹 Italiano