NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #140 most downloaded on Packagist
Handles serializing and deserializing data structures, including object graphs, into array structures or other formats like XML and JSON.
Latest stable
v8.1.11
Last release 9 days ago
13 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Rarely documented
notes for 2 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
787 releases · first in 2011
Drag across the ruler to compare, or tap a release to open it.
Changelog ( v8.2.0-BETA1...v8.2.0-BETA2 )
Changelog (v8.2.0-BETA1...v8.2.0-BETA2)
@extends, @implements and @use tags (@nicolas-grekas)Your coding agent can read these notes before it upgrades. Set up the MCP server →
feature #66254 Deprecate denormalizing a property using its raw name when a name converter is configured ( @mdalikadar )
Changelog (v8.1.11...v8.2.0-BETA1)
command.invocation and migrate command examples (@nicolas-grekas)ObjectNormalizer since # support (@nicolas-grekas)DateTimeImmutable::createFromTimestamp() to build dates from timestamps (@nicolas-grekas)Default is requested next to custom groups (@nicolas-grekas)Type::map() (@mtarld)SerializerDataCollector as they happen (@nicolas-grekas)force_collection option to XmlEncoder (Alexandre Gérault)AbstractNormalizer::IGNORED_GROUPS to make it possible to ignore groups during serialization (@zim32)# with the serializer (@HypeMC)csv_headers to map and reorder columns when encoding (@nicolas-grekas)security #cve-2026-118515 Don't build UploadedFile and other file objects from denormalized data ( @nicolas-grekas )
Changelog (v8.1.10...v8.1.11)
[SECURITY] Security release
bug #67494 Fix autowired normalizers being shared between named serializers ( @nicolas-grekas )
Changelog (v8.1.9...v8.1.10)
DataUriNormalizer denormalized (@nicolas-grekas)[SECURITY] Security release
bug #66862 Rebuild the container when attributes on non-public members change (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.1.8...v8.1.9)
bug #66408 Don't include the debug trace id in the attributes cache key (@javiereguiluz)
Changelog (https://github.com/symfony/serializer/compare/v8.1.7...v8.1.8)
bug #65907 Don't reuse list items with deep_object_to_populate (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.1.6...v8.1.7)
bug #65749 Enforce the element type of nested scalar collections (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.1.5...v8.1.6)
bug #65367 Fix PHP 8.6 deprecations (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.1.4...v8.1.5)
bug #65167 Align union member order between the legacy and TypeInfo paths (@ousamabenyounes)
Changelog (https://github.com/symfony/serializer/compare/v8.1.3...v8.1.4)
minor #65042 Relax PropertyAccess version constraint (@derrabus)
Changelog (https://github.com/symfony/serializer/compare/v8.1.2...v8.1.3)
bug #65025 Check the denormalized class is a Mime part in MimeMessageNormalizer (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.1.1...v8.1.2)
XmlEncoderTest::testEncodeException() when using libxml ≥ 2.13 (@MatTheCat)PhpDocTypeHelper to wrongly assume keys type (@MatTheCat)bug #64718 Fix GetSetMethodNormalizer denormalization of constructor only objects (@mtarld)
Changelog (https://github.com/symfony/serializer/compare/v8.1.0...v8.1.1)
GetSetMethodNormalizer denormalization of constructor only objects (@mtarld)csv_headers context when no_headers is true (@ousamabenyounes)Changelog (https://github.com/symfony/serializer/compare/v8.1.0-BETA3...v8.1.0) * no significant changes
Changelog (https://github.com/symfony/serializer/compare/v8.1.0-BETA3...v8.1.0)
NotNormalizableValueException exception messages in BackedEnumNormalizer to contain more useful informationAbstractObjectNormalizer::ENABLE_TYPE_CONVERSION for scalar type transformationCOLLECT_EXTRA_ATTRIBUTES_ERRORS option to Serializer to collect extra-attributes errors during denormalizationPartialDenormalizationException::getErrors(), use getNotNormalizableValueErrors() insteadbug #64296 Improve normalizer error reporting and deprecations (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.1.0-BETA1...v8.1.0-BETA3)
feature #58966 Trigger deprecation when could not parse date with default format (@alexndlm)
Changelog (https://github.com/symfony/serializer/compare/v8.0.10...v8.1.0-BETA1)
COLLECT_EXTRA_ATTRIBUTES_ERRORS and full deserialization path (@NorthBlue333)AbstractObjectNormalizer::ENABLE_TYPE_CONVERSION for scalar type transformation (@Jeroeny)bug #65025 Check the denormalized class is a Mime part in MimeMessageNormalizer (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.0.14...v8.0.15)
XmlEncoderTest::testEncodeException() when using libxml ≥ 2.13 (@MatTheCat)PhpDocTypeHelper to wrongly assume keys type (@MatTheCat)bug #64718 Fix GetSetMethodNormalizer denormalization of constructor only objects (@mtarld)
Changelog (https://github.com/symfony/serializer/compare/v8.0.10...v8.0.14)
GetSetMethodNormalizer denormalization of constructor only objects (@mtarld)csv_headers context when no_headers is true (@ousamabenyounes)bug #64111 Fix low deps (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.0.9...v8.0.10)
bug #64067 Move type-mismatch and uninitialized-property handling into concrete normalizers (@ousamabenyounes)
Changelog (https://github.com/symfony/serializer/compare/v8.0.8...v8.0.9)
BackedEnumNormalizer unconditionally return null on invalid value if allow_invalid_values is set (@MatTheCat)bug #63817 Fix denormalization of nested array with key types (@mtarld)
Changelog (https://github.com/symfony/serializer/compare/v8.0.7...v8.0.8)
self type reference on promoted constructor parameter (@andersonamuller, @nicolas-grekas)bug #63602 Fix denormalization of magic __set properties (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.0.6...v8.0.7)
__set properties (@nicolas-grekas)bug #57392 Fix propertyPath in ConstraintViolationListNormalizer with MetadataAwareNameConverter (@antten)
Changelog (https://github.com/symfony/serializer/compare/v8.0.5...v8.0.6)
bug #63206 Conflict with phpdocumentor/reflection-docblock >= 6 (all branches) (nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.0.4...v8.0.5)
# to the right metadata (@VincentLanglet)bug #63136 Fix is/has/can accessor naming to strip prefix unless colliding (nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.0.3...v8.0.4)
allow_extra_attributes=false (xersion22)bug symfony/symfony#62797 [Serializer] Fix inconsistent field naming from accessors when using groups (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v8.0.2...v8.0.3)
null values when denormalizing (@MatTheCat)bug symfony/symfony#62682 [Serializer][Validator] Attribute metadata no longer requires container.excluded tags (@HypeMC)
Changelog (https://github.com/symfony/serializer/compare/v8.0.1...v8.0.2)
container.excluded tags (@HypeMC)Remove CsvEncoder::ESCAPE_CHAR_KEY constant and escape character functionality
Remove CsvEncoder::ESCAPE_CHAR_KEY constant and escape character functionality
Remove CsvEncoderContextBuilder::withEscapeChar() method
Remove AbstractNormalizerContextBuilder::withDefaultContructorArguments(), use withDefaultConstructorArguments() instead
Change signature of NameConverterInterface::normalize() and NameConverterInterface::denormalize() methods:
Before:
public function normalize(string $propertyName): string;
public function denormalize(string $propertyName): string;
After:
public function normalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string;
public function denormalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string;
Remove AdvancedNameConverterInterface, use NameConverterInterface instead
Remove ClassMetadataFactoryCompiler, CompiledClassMetadataFactory and CompiledClassMetadataCacheWarmer
Remove class aliases in the Annotation namespace, use attributes instead
Remove getters in attribute classes in favor of public properties
Changelog (https://github.com/symfony/serializer/compare/v8.0.0-RC2...v8.0.0-RC3) * no significant changes
Changelog (https://github.com/symfony/serializer/compare/v8.0.0-RC2...v8.0.0-RC3)
Nothing published for this version
feature symfony/symfony#60153 [Serializer] Allow forcing timezone in DateTimeNormalizer during denormalization (@frankdekker)
Changelog (https://github.com/symfony/serializer/compare/v8.0.0-BETA1...v8.0.0-BETA2)
DateTimeNormalizer during denormalization (@frankdekker)feature symfony/symfony#61487 [Routing][Serializer] Deprecate annotation aliases and getters and setters in favor of public properties on attributes (…
Changelog (https://github.com/symfony/serializer/compare/v7.3.4...v8.0.0-BETA1)
XmlEncoder (Maximilian Ruta)#[ExtendsSerializationFor] to declare new serialization attributes for a class (@nicolas-grekas)__sleep/wakeup() by __(un)serialize() (@nicolas-grekas)__sleep/wakeup() on string implementations (@nicolas-grekas)AttributeMetadata and ClassMetadata final (@nicolas-grekas)CDATA_WRAPPING_NAME_PATTERN support to XmlEncoder (Maximilian Ruta)can to the accessor prefixes recognized by the AttributeLoader (Mark Schmale)escape_char functionality from CsvEncoder (@OskarStark)AdvancedNameConverterInterface (@mttsch)Type (@mtarld)security #cve-2026-118515 Don't build UploadedFile and other file objects from denormalized data ( @nicolas-grekas )
Changelog (v7.4.22...v7.4.23)
[SECURITY] Security release
Changelog ( v7.4.21...v7.4.22 )
Changelog (v7.4.21...v7.4.22)
DataUriNormalizer denormalized (@nicolas-grekas)[SECURITY] Security release
bug #66862 Rebuild the container when attributes on non-public members change (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.4.20...v7.4.21)
bug #66408 Don't include the debug trace id in the attributes cache key (@javiereguiluz)
Changelog (https://github.com/symfony/serializer/compare/v7.4.19...v7.4.20)
bug #65907 Don't reuse list items with deep_object_to_populate (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.4.18...v7.4.19)
bug #65686 Check the denormalized class is a Mime part in MimeMessageNormalizer (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.4.17...v7.4.18)
bug #65367 Fix PHP 8.6 deprecations (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.4.16...v7.4.17)
bug #65167 Align union member order between the legacy and TypeInfo paths (@ousamabenyounes)
Changelog (https://github.com/symfony/serializer/compare/v7.4.15...v7.4.16)
bug #65025 Check the denormalized class is a Mime part in MimeMessageNormalizer (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.4.14...v7.4.15)
XmlEncoderTest::testEncodeException() when using libxml ≥ 2.13 (@MatTheCat)PhpDocTypeHelper to wrongly assume keys type (@MatTheCat)bug #64718 Fix GetSetMethodNormalizer denormalization of constructor only objects (@mtarld)
Changelog (https://github.com/symfony/serializer/compare/v7.4.10...v7.4.14)
GetSetMethodNormalizer denormalization of constructor only objects (@mtarld)csv_headers context when no_headers is true (@ousamabenyounes)bug #64111 Fix low deps (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.4.9...v7.4.10)
bug #64067 Move type-mismatch and uninitialized-property handling into concrete normalizers (@ousamabenyounes)
Changelog (https://github.com/symfony/serializer/compare/v7.4.8...v7.4.9)
BackedEnumNormalizer unconditionally return null on invalid value if allow_invalid_values is set (@MatTheCat)bug #63817 Fix denormalization of nested array with key types (@mtarld)
Changelog (https://github.com/symfony/serializer/compare/v7.4.7...v7.4.8)
self type reference on promoted constructor parameter (@andersonamuller, @nicolas-grekas)bug #63602 Fix denormalization of magic __set properties (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.4.6...v7.4.7)
__set properties (@nicolas-grekas)bug #57392 Fix propertyPath in ConstraintViolationListNormalizer with MetadataAwareNameConverter (@antten)
Changelog (https://github.com/symfony/serializer/compare/v7.4.5...v7.4.6)
bug #63206 Conflict with phpdocumentor/reflection-docblock >= 6 (all branches) (nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.4.4...v7.4.5)
# to the right metadata (@VincentLanglet)bug #63136 Fix is/has/can accessor naming to strip prefix unless colliding (nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.4.3...v7.4.4)
allow_extra_attributes=false (xersion22)bug symfony/symfony#62797 [Serializer] Fix inconsistent field naming from accessors when using groups (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.4.2...v7.4.3)
null values when denormalizing (@MatTheCat)bug symfony/symfony#62682 [Serializer][Validator] Attribute metadata no longer requires container.excluded tags (@HypeMC)
Changelog (https://github.com/symfony/serializer/compare/v7.4.1...v7.4.2)
container.excluded tags (@HypeMC)Changelog (https://github.com/symfony/serializer/compare/v7.4.0-RC3...v7.4.0) * no significant changes
Changelog (https://github.com/symfony/serializer/compare/v7.4.0-RC3...v7.4.0)
#[ExtendsSerializationFor] to declare new serialization attributes for a classAttributeMetadataPass to declare compile-time constraint metadata using attributesCDATA_WRAPPING_NAME_PATTERN support to XmlEncodercan*() methods to AttributeLoaderAttributeMetadata and ClassMetadata finalXmlEncoder::PRESERVE_NUMERIC_KEYS context optionAnnotation namespace, use attributes insteadClassMetadataFactoryCompilerFORCE_TIMEZONE_KEY to DateTimeNormalizer to force the timezone during denormalizationChangelog (https://github.com/symfony/serializer/compare/v7.4.0-RC2...v7.4.0-RC3) * no significant changes
Changelog (https://github.com/symfony/serializer/compare/v7.4.0-RC2...v7.4.0-RC3)
bug symfony/symfony#58473 [Serializer] Fix AbstractObjectNormalizer to allow scalar values to be normalized (@Hanmac, @xabbuh)
Changelog (https://github.com/symfony/serializer/compare/v7.4.0-BETA2...v7.4.0-RC1)
AbstractObjectNormalizer to allow scalar values to be normalized (@Hanmac, @xabbuh)feature symfony/symfony#60153 [Serializer] Allow forcing timezone in DateTimeNormalizer during denormalization (@frankdekker)
Changelog (https://github.com/symfony/serializer/compare/v7.4.0-BETA1...v7.4.0-BETA2)
DateTimeNormalizer during denormalization (@frankdekker)feature symfony/symfony#61487 [Routing][Serializer] Deprecate annotation aliases and getters and setters in favor of public properties on attributes (…
Changelog (https://github.com/symfony/serializer/compare/v7.3.4...v7.4.0-BETA1)
XmlEncoder (Maximilian Ruta)#[ExtendsSerializationFor] to declare new serialization attributes for a class (@nicolas-grekas)__sleep/wakeup() on string implementations (@nicolas-grekas)AttributeMetadata and ClassMetadata final (@nicolas-grekas)CDATA_WRAPPING_NAME_PATTERN support to XmlEncoder (Maximilian Ruta)can to the accessor prefixes recognized by the AttributeLoader (Mark Schmale)bug #63206 Conflict with phpdocumentor/reflection-docblock >= 6 (all branches) (nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.3.10...v7.3.11)
# to the right metadata (@VincentLanglet)bug #63136 Fix is/has/can accessor naming to strip prefix unless colliding (nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.3.9...v7.3.10)
allow_extra_attributes=false (xersion22)bug symfony/symfony#62797 [Serializer] Fix inconsistent field naming from accessors when using groups (@nicolas-grekas)
Changelog (https://github.com/symfony/serializer/compare/v7.3.8...v7.3.9)
null values when denormalizing (@MatTheCat)bug symfony/symfony#58473 [Serializer] Fix AbstractObjectNormalizer to allow scalar values to be normalized (@Hanmac, @xabbuh)
Changelog (https://github.com/symfony/serializer/compare/v7.3.7...v7.3.8)
AbstractObjectNormalizer to allow scalar values to be normalized (@Hanmac, @xabbuh)One column per quarter.