PHPackages chamber-orchestra/view-bundle - 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. chamber-orchestra/view-bundle ActiveSymfony-bundle[Database & ORM](/categories/database) chamber-orchestra/view-bundle ============================= Symfony bundle providing a typed, reusable view layer for building JSON API responses with automatic property binding and cache-warmed serialization v8.0.23(2mo ago)228588↓35.7%235MITPHPPHP ^8.5CI passing Since Mar 6Pushed 2mo ago3 watchersCompare [ Source](https://github.com/chamber-orchestra/view-bundle)[ Packagist](https://packagist.org/packages/chamber-orchestra/view-bundle)[ Docs](https://github.com/chamber-orchestra/view-bundle)[ RSS](/packages/chamber-orchestra-view-bundle/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (13)Versions (37)Used By (5) [![PHP Composer](https://github.com/chamber-orchestra/view-bundle/actions/workflows/php.yml/badge.svg)](https://github.com/chamber-orchestra/view-bundle/actions/workflows/php.yml)[![PHPStan](https://camo.githubusercontent.com/745eb989b9e4903dc598fe2cc63ed4226198be55b7c729001cbd1ece7676fef6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6d61782d627269676874677265656e2e737667)](https://phpstan.org/)[![PHP-CS-Fixer](https://camo.githubusercontent.com/6ea88fbe545f6f06950dd97b31be7621fcb0a0056644de2ea36e44b7de33adc4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f64652532307374796c652d5045522d2d435325323025324625323053796d666f6e792d626c75652e737667)](https://cs.symfony.com/)[![Latest Stable Version](https://camo.githubusercontent.com/19b2451a5251901234787173016dee85793320401924856e63384310a1763b44/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6368616d6265722d6f72636865737472612f766965772d62756e646c652e737667)](https://packagist.org/packages/chamber-orchestra/view-bundle)[![Total Downloads](https://camo.githubusercontent.com/572237f23b26db09606549c03be193a19760f1b6d376606a406badbaa2f77eeb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6368616d6265722d6f72636865737472612f766965772d62756e646c652e737667)](https://packagist.org/packages/chamber-orchestra/view-bundle)[![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](LICENSE)[![PHP 8.5+](https://camo.githubusercontent.com/2371eeb1a98f81a6894947d4d7b429326ee7f4dbeb3d8940776b4ae7b8442725/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e352532422d3737374242342e737667)](https://www.php.net/)[![Symfony 8.0](https://camo.githubusercontent.com/daaa476b3cc456701380f7d0fbdc3bbe9983e89d3267f99870daa88aa719e181/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d382e302d3030303030302e737667)](https://symfony.com/) ChamberOrchestra View Bundle ============================ [](#chamberorchestra-view-bundle) A Symfony bundle that provides a **typed view layer for JSON API responses**. Define response shapes as PHP classes, return them from controllers, and let the bundle handle serialization automatically — no manual `JsonResponse` construction needed. Built for **Symfony 8.0** and **PHP 8.5+**, the bundle eliminates boilerplate in REST API controllers by introducing view models with automatic property binding, collection mapping, and production-ready cache warming. Key Features ------------ [](#key-features) - **Typed view models** — define JSON response structures as PHP classes with typed properties - **Automatic property binding** — `BindView` maps domain object properties to view properties via reflection - **Collection mapping** — `IterableView` transforms arrays and iterables with typed element views - **Null stripping** — null values are automatically excluded from serialized JSON output - **Build-time cache warming** — pre-computed metadata and property mappings eliminate reflection overhead in production - **Build-versioned caching** — cache files are tied to `container.build_id` for zero-downtime deployments - **Doctrine proxy support** — transparent lazy-load initialization before property access Requirements ------------ [](#requirements) - PHP 8.5+ - Symfony 8.0 components (http-kernel, serializer, property-access, dependency-injection, config, framework-bundle) - doctrine/common ^3.5 Installation ------------ [](#installation) ``` composer require chamber-orchestra/view-bundle:8.0.* ``` Enable the bundle in `config/bundles.php`: ``` return [ // ... ChamberOrchestra\ViewBundle\ChamberOrchestraViewBundle::class => ['all' => true], ]; ``` Quick Start ----------- [](#quick-start) Define a view model that maps properties from a domain object: ``` use ChamberOrchestra\ViewBundle\Attribute\BindsFrom; use ChamberOrchestra\ViewBundle\Attribute\Type; use ChamberOrchestra\ViewBundle\View\BindView; use ChamberOrchestra\ViewBundle\View\IterableView; #[BindsFrom(User::class)] final class UserView extends BindView { public string $id; public string $name; #[Type(ImageView::class)] public IterableView $images; public function __construct(User $user) { parent::__construct($user); } } final class ImageView extends BindView { public string $path; } ``` Return the view from a controller — the bundle converts it to a `JsonResponse` automatically: ``` #[Route('/user/me', methods: ['GET'])] final class GetMeAction { public function __invoke(): UserView { return new UserView($this->getUser()); } } ``` `ViewSubscriber` converts any `ViewInterface` result into a `JsonResponse`. Non-view results pass through unchanged. View Types ---------- [](#view-types) ViewPurpose`ResponseView`Base response with HTTP status (200) and `Content-Type: application/json` headers`DataView`Wraps any view or array under a `"data"` key`BindView`Maps matching properties from a source object using reflection`IterableView`Maps collections via a callback or view class string`KeyValueView`Produces associative array output for metadata blocks### BindView Property Binding [](#bindview-property-binding) `BindView` uses `BindUtils` to synchronize properties between source objects and view instances. It handles: - Built-in PHP types and custom objects - `ViewInterface` subclasses (auto-constructed) - `IterableView` properties with `#[Type(ViewClass::class)]` attribute for typed collections - Skips union types and incompatible type pairs Architecture ------------ [](#architecture) ### Request/Response Flow [](#requestresponse-flow) 1. **SetVersionSubscriber** (priority 256) — injects the DI-managed `BindUtils` instance into `BindView` via `BindView::setBindUtils()` 2. Controller returns a `ViewInterface` object 3. **ViewSubscriber** — detects `ViewInterface` results, wraps non-`ResponseViewInterface` in `DataView`, serializes to JSON via `ViewNormalizer` ### View Auto-Discovery [](#view-auto-discovery) Views implementing `ViewInterface` are automatically tagged with `chamber_orchestra.view` via `#[AutoconfigureTag]`. The `ViewPass` compiler pass collects these classes and passes them to cache warmers for pre-computation. Performance Optimizations ------------------------- [](#performance-optimizations) The bundle includes a two-phase optimization strategy for production environments: ### Phase 1: Runtime Metadata Caching [](#phase-1-runtime-metadata-caching) - `ViewMetadataFactory` caches property metadata in memory - Direct property access eliminates repeated reflection calls - 30-50% faster normalization on repeated calls ### Phase 2: Build-Time Cache Warming [](#phase-2-build-time-cache-warming) - `ViewMetadataCacheWarmer` pre-computes view property metadata at build time - `BindUtilsCacheWarmer` pre-computes property mappings (uses `#[BindsFrom]` for targeted source classes, falls back to N² pairs) - Generated opcache-optimized PHP files stored in `kernel.share_dir` - Cache files are versioned with `container.build_id` for safe deployments - 60-80% reduction in reflection overhead on production requests - Automatic fallback to reflection when warmed cache is unavailable ### Cache Configuration [](#cache-configuration) `BindUtils` is registered as a DI service with `$buildId`, `$debug`, and `$shareDir` constructor arguments. When `APP_DEBUG=false`, property accessor caching is enabled with a 24-hour lifetime. `SetVersionSubscriber` injects the configured instance into `BindView` on each request. **Warm the cache in production:** ``` bin/console cache:warmup --env=prod ``` This generates build-versioned files in the shared cache directory: - View property metadata (nullability, defaults, types) - View-to-view property mappings for `BindUtils` Benchmarks ---------- [](#benchmarks) PHPBench benchmarks are included to measure serialization performance and cache impact: ``` composer bench # Run all benchmarks vendor/bin/phpbench run --report=default # Run with default report ``` Benchmark classes: `BindUtilsBench`, `CacheWarmupBench`, `NormalizationBench`. Development ----------- [](#development) ``` composer install # Install dependencies composer test # Run all tests (93 tests, 328 assertions) ./bin/phpunit # Run tests directly ./bin/phpunit --filter X # Run specific test class or method ``` License ------- [](#license) MIT ### Health Score 57 — FairBetter than 98% of packages Maintenance86 Actively maintained with recent releases Popularity38 Limited adoption so far Community22 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 94.4% 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 ~24 days Recently: every ~1 days Total 31 Last Release 73d ago Major Versions 7.3.x-dev → v8.0.12025-12-29 PHP version history (3 changes)v7.0.1PHP ^8.3 v7.2.0PHP ^8.4 v8.0.10PHP ^8.5 ### Community Maintainers ![](https://www.gravatar.com/avatar/44037eb1c8dc2c4fa9871ac213653f33e22a9348dcec7132df07cc71933f2a2e?d=identicon)[wtorsi](/maintainers/wtorsi) --- Top Contributors [![wtorsi](https://avatars.githubusercontent.com/u/2115840?v=4)](https://github.com/wtorsi "wtorsi (34 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)") --- Tags doctrinejsonjson-apiphpphp8property-bindingrest-apiserializationsymfonysymfony-bundleview-modeljsonsymfonyserializationviewREST APIJSON-APISymfony Bundleview-modelapi-responseproperty-binding ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/chamber-orchestra-view-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/chamber-orchestra-view-bundle/health.svg)](https://phpackages.com/packages/chamber-orchestra-view-bundle) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M648](/packages/sylius-sylius)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M386](/packages/shopware-core)[web-auth/webauthn-framework FIDO2/Webauthn library for PHP and Symfony Bundle. 50570.7k1](/packages/web-auth-webauthn-framework)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)