PHPackages vuryss/serializer - 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. [Parsing & Serialization](/categories/parsing) 4. / 5. vuryss/serializer ActiveLibrary[Parsing & Serialization](/categories/parsing) vuryss/serializer ================= A fast, extensible PHP data structures serializer & deserializer v4.0.0(2mo ago)110.4k↓36.1%[5 PRs](https://github.com/vuryss/serializer/pulls)2MITPHPPHP ^8.5CI passing Since Jun 24Pushed 1mo ago2 watchersCompare [ Source](https://github.com/vuryss/serializer)[ Packagist](https://packagist.org/packages/vuryss/serializer)[ RSS](/packages/vuryss-serializer/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (26)Versions (30)Used By (2) Fast serialization library ========================== [](#fast-serialization-library) [![Tests](https://github.com/vuryss/serializer/actions/workflows/tests.yml/badge.svg?branch=master)](https://github.com/vuryss/serializer/actions/workflows/tests.yml)[![codecov](https://camo.githubusercontent.com/aaf111bfff61312377c64ecabb55343f8d1c5412899a04d85ed889669b6bc126/68747470733a2f2f636f6465636f762e696f2f67682f7675727973732f73657269616c697a65722f67726170682f62616467652e7376673f746f6b656e3d6b4b305a486833726141)](https://codecov.io/gh/vuryss/serializer)[![Codacy Badge](https://camo.githubusercontent.com/99353705d03cd20a2285a963cc980c129c9ccb4ff0efa74ff4b16c606221925e/68747470733a2f2f6170702e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f3736306533643466393835323438666438626234376239343738373362383437)](https://app.codacy.com/gh/vuryss/serializer/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)[![CodeFactor](https://camo.githubusercontent.com/43b99ce62f9f557dcf3a66f4f2f6a161bf455166ffadd7bc55beac28e7c5f974/68747470733a2f2f7777772e636f6465666163746f722e696f2f7265706f7369746f72792f6769746875622f7675727973732f73657269616c697a65722f6261646765)](https://www.codefactor.io/repository/github/vuryss/serializer)[![GitHub Release](https://camo.githubusercontent.com/c063addb7c28c9cc3da7ed4de909eb878ca9aa87af5241568d2d3489b4a9f2b4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f7675727973732f73657269616c697a6572)](https://camo.githubusercontent.com/c063addb7c28c9cc3da7ed4de909eb878ca9aa87af5241568d2d3489b4a9f2b4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f7675727973732f73657269616c697a6572)[![GitHub License](https://camo.githubusercontent.com/a280cf0a331618d0758e722e3b05fb4ac92ed39c0615f479280226c0f401da4f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7675727973732f73657269616c697a6572)](https://camo.githubusercontent.com/a280cf0a331618d0758e722e3b05fb4ac92ed39c0615f479280226c0f401da4f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7675727973732f73657269616c697a6572) Serializes and deserializes complex data structures to and from json. Ideas taken from Symfony's Serializer component, Serde and others. Symfony serializer was very flexible, but also very slow. This library tries to be as fast as possible. Supports modern PHP projects with fully typed properties. Older codebases with no types would not work. Benchmarks comparing this library with Symfony Serializer and Serde can be found here: [Here](https://github.com/vuryss/serializer-benchmark) - [Fast serialization library](#fast-serialization-library) - [Installation](#installation) - [Features](#features) - [Serialization](#serialization) - [Deserialization](#deserialization) - [Caching - optional, but highly recommended, otherwise the library will be slow](#caching---optional--but-highly-recommended--otherwise-the-library-will-be-slow) - [Custom object property serialized name](#custom-object-property-serialized-name) - [Serialization groups](#serialization-groups) - [Deserialization groups](#deserialization-groups) - [Custom date format](#custom-date-format) - [Enforce date format](#enforce-date-format) - [Convert date to timezone](#convert-date-to-timezone) - [Ignore property](#ignore-property) - [Handling of NULL values](#handling-of-null-values) - [Support for json serializable objects](#support-for-json-serializable-objects) - [Support for Symfony Serializer attributes](#support-for-symfony-serializer-attributes) - [Build, run & test locally](#build--run---test-locally) Installation ------------ [](#installation) ``` composer require vuryss/serializer ``` The library supports Symfony 7.4 LTS and Symfony 8.x. Features -------- [](#features) ### Serialization [](#serialization) - Properties are serialized if they are either public or have a getter method. ``` $person = new Person(); $person->firstName = 'Maria'; $person->lastName = 'Valentina'; $person->age = 36; $person->isStudent = false; $serializer = new Serializer(); $json = $serializer->serialize($person); // {"firstName":"Maria","lastName":"Valentina","age":36,"isStudent":false} ``` ### Deserialization [](#deserialization) - Properties are deserialized if they are public, instantiable in public constructor or have a setter method. ``` $json = '{"firstName":"Maria","lastName":"Valentina","age":36,"isStudent":false}'; $serializer = new Serializer(); $person = $serializer->deserialize($json, Person::class); ``` ### Caching - optional, but highly recommended, otherwise the library will be slow [](#caching---optional-but-highly-recommended-otherwise-the-library-will-be-slow) Supports PSR-6 CacheItemPoolInterface: No need to chain in-memory cache with external cache, the library will do it for you. Cache will be called once per used class (used in serialization or deserialization), then will be cached in memory until the script ends. ``` $pst6cache = new CacheItemPool(); // Some PSR-6 cache implementation $serializer = new Serializer( metadataExtractor: new CachedMetadataExtractor( new MetadataExtractor(), $pst6cache, ), ); ``` ### Custom object property serialized name [](#custom-object-property-serialized-name) ``` class SomeClass { #[SerializerContext(name: 'changedPropertyName')] public string $someProperty; } ``` ### Serialization groups [](#serialization-groups) ``` use Vuryss\Serializer\Context; class SomeClass { #[SerializerContext(groups: ['group1'])] public string $property1; // Has implicit group 'default' public string $property2; } $serializer = new Serializer(); $object = new SomeClass(); $object->property1 = 'value1'; $object->property2 = 'value2'; $serializer->serialize($object, context: [Context::GROUPS => ['group1']]); // {"property1":"value1"} ``` ### Deserialization groups [](#deserialization-groups) ``` use Vuryss\Serializer\Context; class SomeClass { #[SerializerContext(groups: ['group1'])] public string $property1; // Has implicit group 'default' public string $property2; } $serializer = new Serializer(); $data = '{"property1":"value1","property2":"value2"}'; $object = $serializer->deserialize($data, SomeClass::class, context: [Context::GROUPS => ['group1']]); isset($object->property1); // true isset($object->property2); // false ``` ### Custom date format [](#custom-date-format) On serialization the format will always be respected. On deserialization the format will be used to parse the date. However on deserialization by default if the date is not in the provided format, it will be parsed as is, given that DateTime constructor can parse it. Per property: ``` use Vuryss\Serializer\Context; class SomeClass { #[SerializerContext(context: [Context::DATETIME_FORMAT => 'Y-m-d'])] public DateTime $someDate; } ``` Or globally: ``` use Vuryss\Serializer\Context; $serializer = new Serializer( context: [ Context::DATETIME_FORMAT => \DateTimeInterface::RFC2822, ] ); ``` ### Enforce date format [](#enforce-date-format) If strict data time format is required during deserialization then, you can use the `Context::DATETIME_FORMAT_STRICT` context option: Per property: ``` use Vuryss\Serializer\Context; class SomeClass { #[SerializerContext(context: [ Context::DATETIME_FORMAT => 'Y-m-d', Context::DATETIME_FORMAT_STRICT => true ])] public DateTime $someDate; } ``` Or globally: ``` use Vuryss\Serializer\Context; $serializer = new Serializer( context: [ Context::DATETIME_FORMAT => 'Y-m-d', Context::DATETIME_FORMAT_STRICT => true ] ); ``` ### Convert date to timezone [](#convert-date-to-timezone) After denormalization, the `DateTime` object can be converted to a specific timezone. Per property: ``` use Vuryss\Serializer\Context; class SomeClass { #[SerializerContext(context: [Context::DATETIME_TARGET_TIMEZONE => 'UTC'])] public DateTime $someDate; } ``` Or globally: ``` use Vuryss\Serializer\Context; $serializer = new Serializer( context: [ Context::DATETIME_TARGET_TIMEZONE => 'UTC', ] ); ``` ### Ignore property [](#ignore-property) Those properties will not be included in the serialized values during serialization and will not be populated with provided values during deserialization. ``` class SomeClass { #[SerializerContext(ignore: true)] public string $someProperty; } ``` ### Handling of NULL values [](#handling-of-null-values) - By default, NULL values are included in the serialized value. To disable this you can use the `Context::SKIP_NULL_VALUES` context option: Per property: ``` use Vuryss\Serializer\Context; class SomeClass { #[SerializerContext(context: [Context::SKIP_NULL_VALUES => true])] public ?string $someProperty; } ``` Or globally: ``` use Vuryss\Serializer\Context; $serializer = new Serializer( context: [ Context::SKIP_NULL_VALUES => true, ] ); ``` ### Support for json serializable objects [](#support-for-json-serializable-objects) If an object implements the `JsonSerializable` interface, the `jsonSerialize` method will be called and the result will be serialized. ### Support for Symfony Serializer attributes [](#support-for-symfony-serializer-attributes) This library aims to be a drop-in replacement for Symfony Serializer. It supports the following attributes: - Groups - SerializedName - Ignore - DiscriminatorMap Build, run & test locally ----------------------------- [](#build-run--test-locally) To enter the prepared container environment: ``` docker-compose up -d docker-compose exec library bash ``` Install package dependencies: ``` docker-compose exec library composer install -o ``` Run the default local quality suite against the locked latest dependencies (Symfony 8.x): ``` docker-compose exec library composer qa ``` Reproduce the Symfony compatibility matrix locally when needed: ``` docker-compose exec library composer deps:lowest docker-compose exec library composer qa docker-compose exec library composer deps:highest docker-compose exec library composer qa ``` `composer deps:lowest` rewrites composer.lock to the minimum supported dependency set, while `composer deps:highest` restores the latest supported set. HTML Coverage locally: ``` docker-compose exec library XDEBUG_MODE=coverage vendor/bin/pest --coverage --coverage-html=coverage ``` ### Health Score 53 — FairBetter than 97% of packages Maintenance88 Actively maintained with recent releases Popularity26 Limited adoption so far Community18 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 69.6% 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 ~34 days Recently: every ~86 days Total 19 Last Release 67d ago Major Versions v1.11.0 → v2.0.02025-06-19 v2.0.0 → v3.0.02025-12-15 v3.0.0 → v4.0.02026-03-12 PHP version history (3 changes)v1.0.0PHP ^8.3 v1.10.0PHP ^8.4 v4.0.0PHP ^8.5 ### Community Maintainers ![](https://www.gravatar.com/avatar/70759f4deef30c94bac54f3c2243202d62595f3b55c9a4f88b19f32c1bcfad0f?d=identicon)[vuryss](/maintainers/vuryss) --- Top Contributors [![vuryss](https://avatars.githubusercontent.com/u/7021705?v=4)](https://github.com/vuryss "vuryss (96 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (38 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)")[![frwuttke](https://avatars.githubusercontent.com/u/108340101?v=4)](https://github.com/frwuttke "frwuttke (1 commits)") ### Code Quality TestsPest Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/vuryss-serializer/health.svg) ``` [![Health](https://phpackages.com/badges/vuryss-serializer/health.svg)](https://phpackages.com/packages/vuryss-serializer) ``` ### Alternatives [symfony/serializer-pack A pack for the Symfony serializer 1.1k28.2M221](/packages/symfony-serializer-pack)[nelmio/api-doc-bundle Generates documentation for your REST API from attributes 2.3k63.6M233](/packages/nelmio-api-doc-bundle)[jms/serializer Library for (de-)serializing data of any complexity; supports XML, and JSON. 2.3k135.8M851](/packages/jms-serializer)[jolicode/automapper JoliCode AutoMapper 213439.4k7](/packages/jolicode-automapper)[symfony/ai-platform PHP library for interacting with AI platform provider. 51927.7k136](/packages/symfony-ai-platform)[api-platform/metadata API Resource-oriented metadata attributes and factories 243.5M96](/packages/api-platform-metadata) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)