PHPackages                             exsyst/normalizer-extra-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. [Templating &amp; Views](/categories/templating)
4. /
5. exsyst/normalizer-extra-bundle

ActiveLibrary[Templating &amp; Views](/categories/templating)

exsyst/normalizer-extra-bundle
==============================

An icing on top of the Symfony serializer cake

0.4.6(1y ago)03.4k[2 issues](https://github.com/EXSyst/normalizer-extra-bundle/issues)MITPHPPHP ^8.3.0CI failing

Since May 23Pushed 1y ago2 watchersCompare

[ Source](https://github.com/EXSyst/normalizer-extra-bundle)[ Packagist](https://packagist.org/packages/exsyst/normalizer-extra-bundle)[ RSS](/packages/exsyst-normalizer-extra-bundle/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (7)Versions (18)Used By (0)

What is that?
=============

[](#what-is-that)

A mostly opinionated bundle which aims to ease creation of efficient API servers with the Symfony serializer, while trying to stay lightweight.

How to use?
===========

[](#how-to-use)

1. Make sure you have a Symfony 3.\* or 4.\* project, with the Serializer component, and the Doctrine ORM ;
2. Run `composer require exsyst/normalizer-extra-bundle` in your project ;
3. Add a section to your project configuration to choose the features you want to use (see below) ;
4. Further customize and/or extend the bundle's behavior if you want (documentation will come later) ;
5. Start (de)serializing things!

Features and default configuration
==================================

[](#features-and-default-configuration)

The only features that are enabled by default are the ones that :

- Are inert on their own, or ;
- Define a reasonable, unopinionated behavior for cases that were completely unsupported.

```
exsyst_normalizer_extra:
  features:
    # Makes $request->request able to access the request body in the
    # Content-Type: application/json, application/xml, application/x-yaml,
    # text/csv cases and/or others depending on serializer support.
    # Enabled by default.
    request_decoder: true

    # Parses a JSON document in a header named "Response-Shape",
    # into a request attribute named "shape", used so that the client
    # can filter out unneeded fields.
    # Enabled by default.
    response_shape_header: true

    # Allows a controller to return an object or null and have it
    # automatically turned into a Response.
    # Disabled by default.
    serializer_view_listener: false

    # Allows a controller to throw a HttpException and have it
    # automatically turned into a Response.
    # Disabled by default.
    serializer_exception_listener: false

  normalizers:
    # A normalizer geared towards Doctrine collections, which also
    # supports most iterables (though in a limited way).
    # Disabled by default.
    collection: false

    # A normalizer for PHP 8.1+ enums. It will normalize backed enum
    # cases into their values, and unit enum cases into their names.
    # Disabled by default.
    enum: false

    # A meta-normalizer that can generate fast normalizers for most
    # classes, and delegate to them.
    # Disabled by default.
    specializing: false
  options:
    # Always use a breadth-first normalization algorithm, that can
    # optimize initialization operations by batching them.
    # Some normalizers may be incompatible.
    # Disabled by default.
    implicit_breadth_first: false

    # When using the breadth-first normalization algorithm (see above),
    # only normalize each object once in each normalized graph.
    # An object that appears at several places will have its extra
    # properties merged into the first normalized instance, and the
    # other instances will be replaced by stubs.
    # Disabled by default.
    implicit_merge_objects: false

    # Automatically provides metadata consumers with information
    # obtained by using Symfony's PropertyInfo component and serializer
    # metadata, Doctrine's mappings, and attributes.
    # Enabled by default.
    auto_metadata: true

    # Parameters to use in the (de)serialization context of the services
    # defined by enabling the above features.
    # Null by default, which is treated the same as an empty mapping.
    default_context: ~
  unsafe_features:
    # Optimizes Doctrine collection initializations by batching them.
    # Disabled by default.
    collection_batching: false

    # Optimizes Doctrine entity proxy initializations by batching them.
    # Disabled by default.
    entity_batching: false
```

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance42

Moderate activity, may be stable

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity73

Established project with proven stability

 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 ~129 days

Recently: every ~59 days

Total

17

Last Release

483d ago

PHP version history (3 changes)0.1.0PHP ^7.1.3

0.3.0PHP ^7.4.7

0.4.0PHP ^8.3.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/737775da915b569820ab1bbbb67424356fbe2fed9b157f57c65474e4eb35891f?d=identicon)[EXSyst](/maintainers/EXSyst)

![](https://www.gravatar.com/avatar/8789b6246ea714f84b9ea6490a1d75175205e9c130e076ee20ccff121fb916df?d=identicon)[Exter-N](/maintainers/Exter-N)

---

Top Contributors

[![Exter-N](https://avatars.githubusercontent.com/u/2236342?v=4)](https://github.com/Exter-N "Exter-N (49 commits)")

---

Tags

jsonphpserializersymfony-bundle

### Embed Badge

![Health badge](/badges/exsyst-normalizer-extra-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/exsyst-normalizer-extra-bundle/health.svg)](https://phpackages.com/packages/exsyst-normalizer-extra-bundle)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[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)[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)
