NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1185 most downloaded on Packagist
Provides a way to map an object to another object
Latest stable
v8.1.11
Last release 10 days ago
12 Nov 2026
Release timing varies
gaps range from 8 days to 6 weeks
Nearly every release is documented
notes for 36 of 37 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
52 releases · first in 2025
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)
Changelog ( v8.1.11...v8.2.0-BETA1 )
Changelog (v8.1.11...v8.2.0-BETA1)
# attributes map to the same property (@nicolas-grekas)Your coding agent can read these notes before it upgrades. Set up the MCP server →
Changelog ( v8.1.10...v8.1.11 )
Changelog (v8.1.10...v8.1.11)
[SECURITY] Security release
bug #67268 Remove @internal from Mapping ( @nikophil )
Changelog (v8.1.9...v8.1.10)
@internal from Mapping (@nikophil)[SECURITY] Security release
bug #66756 Honor the target property # that leaves source out in the reverse class map ( @nicolas-grekas )
Changelog (v8.1.8...v8.1.9)
# that leaves source out in the reverse class map (@nicolas-grekas)bug #66410 Construct nested lazy-ghost targets when the mapper is decorated ( @dylan-rumble )
Changelog (v8.1.5...v8.1.8)
bug #65385 Allow # on abstract classes ( @nicolas-grekas )
Changelog (v8.1.4...v8.1.5)
bug #65154 Fix target property mappings dropped when the source carries metadata (@ousamabenyounes)
Changelog (https://github.com/symfony/object-mapper/compare/v8.1.2...v8.1.4)
bug #64983 Fix nested map() reconstructing an existing target (@takashiraki)
Changelog (https://github.com/symfony/object-mapper/compare/v8.1.1...v8.1.2)
minor #64643 Fix reverse class mapping of private properties from parent classes (@Amoifr)
Changelog (https://github.com/symfony/object-mapper/compare/v8.1.0...v8.1.1)
bug #64358 Fix TargetClass generic type in ConditionCallableInterface (Mudassar Ali)
Changelog (https://github.com/symfony/object-mapper/compare/v8.1.0-BETA3...v8.1.0)
targetClass option to MapCollectionObjectMapperAwareInterface to inject the current object mapper instance to transformersSourceClass, ClassRule, and ClassRuleList condition callables to match mapping rules based on source/target classTargetClass and SourceClass to accept arrays of class FQDNsIsNotNull built-in condition to skip mapping when a source property value is nullbug #64251 Various fixes and hardenings (@nicolas-grekas)
Changelog (https://github.com/symfony/object-mapper/compare/v8.1.0-BETA1...v8.1.0-BETA3)
bug #63789 Fix # attribute breaking auto-mapping of other properties (@Amoifr)
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.9...v8.1.0-BETA1)
IsNotNull built-in condition (@Nayte91)targetClass on MapCollection transform (@soyuka)bug #64983 Fix nested map() reconstructing an existing target (@takashiraki)
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.14...v8.0.15)
bug #63791 Fix mapping of private properties from parent classes (@Amoifr)
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.9...v8.0.14)
bug #63889 Auto-inject ObjectMapper into ObjectMapperAwareInterface transforms (@Amoifr)
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.6...v8.0.9)
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.7...v8.0.8) * no significant changes
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.7...v8.0.8)
bug #63446 fix nested mapping with class-level transform (Thibaut Cholley)
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.5...v8.0.6)
bug #63141 apply conditions to constructor arguments (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.4...v8.0.5)
bug #63027 error when multiple targets and no condition (soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.3...v8.0.4)
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.0...v8.0.1) * no significant changes
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.0...v8.0.1)
Nothing published for this version
bug symfony/symfony#62454 [ObjectMapper] mapping of nested classes with promoted read-only properties (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.0-RC2...v8.0.0-RC3)
Nothing published for this version
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.0-BETA1...v8.0.0-BETA2) * no significant changes
Changelog (https://github.com/symfony/object-mapper/compare/v8.0.0-BETA1...v8.0.0-BETA2)
feature symfony/symfony#61497 [ObjectMapper] cache attributes in memory (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.4...v8.0.0-BETA1)
ObjectMapperAwareInterface to set the owning object mapper instance (@soyuka)Changelog ( v7.4.22...v7.4.23 )
Changelog (v7.4.22...v7.4.23)
[SECURITY] Security release
Changelog ( v7.4.20...v7.4.22 )
Changelog (v7.4.20...v7.4.22)
@internal from Mapping (@nikophil)[SECURITY] Security release
Changelog ( v7.4.17...v7.4.20 )
Changelog (v7.4.17...v7.4.20)
bug #65366 Only honor an explicitly inbound target # for the same-name copy (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.16...v7.4.17)
bug #65154 Fix target property mappings dropped when the source carries metadata (@ousamabenyounes)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.15...v7.4.16)
bug #64983 Fix nested map() reconstructing an existing target (@takashiraki)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.14...v7.4.15)
bug #63791 Fix mapping of private properties from parent classes (@Amoifr)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.9...v7.4.14)
bug #63889 Auto-inject ObjectMapper into ObjectMapperAwareInterface transforms (@Amoifr)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.6...v7.4.9)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.7...v7.4.8) * no significant changes
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.7...v7.4.8)
bug #63446 fix nested mapping with class-level transform (Thibaut Cholley)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.5...v7.4.6)
bug #63141 apply conditions to constructor arguments (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.4...v7.4.5)
bug #63027 error when multiple targets and no condition (soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.3...v7.4.4)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.0-RC3...v7.4.0) * no significant changes
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.0-RC3...v7.4.0)
@experimental anymoreObjectMapperAwareInterface to set the owning object mapper instanceMapCollection transform that calls the Mapper over iterable propertiesbug symfony/symfony#62454 [ObjectMapper] mapping of nested classes with promoted read-only properties (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.0-RC2...v7.4.0-RC3)
bug symfony/symfony#62214 [ObjectMapper] lazy loading (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.0-BETA2...v7.4.0-RC1)
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.0-BETA1...v7.4.0-BETA2) * no significant changes
Changelog (https://github.com/symfony/object-mapper/compare/v7.4.0-BETA1...v7.4.0-BETA2)
feature symfony/symfony#61497 [ObjectMapper] cache attributes in memory (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.4...v7.4.0-BETA1)
ObjectMapperAwareInterface to set the owning object mapper instance (@soyuka)Changelog (https://github.com/symfony/object-mapper/compare/v7.3.5...v7.3.6) * no significant changes
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.5...v7.3.6)
bug symfony/symfony#61785 [ObjectMapper] Preserve non-promoted constructor parameters (@rvanlaak)
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.3...v7.3.4)
bug symfony/symfony#61310 [ObjectMapper] read source metadata before transform (@soyuka, @rvanlaak)
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.2...v7.3.3)
bug symfony/symfony#61233 [ObjectMapper] skip reading uninitialized values (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.1...v7.3.2)
bug symfony/symfony#60831 [ObjectMapper] Fix parameter passed to class level transform (@mttsch)
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.0...v7.3.1)
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.0-RC1...v7.3.0) * no significant changes
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.0-RC1...v7.3.0)
bug symfony/symfony#60491 [ObjectMapper] added earlier skip to allow if=false when using source mapping (@maciekpaprocki)
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.0-BETA2...v7.3.0-RC1)
feature symfony/symfony#60028 [ObjectMapper] Condition to target a specific class (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v7.3.0-BETA1...v7.3.0-BETA2)
feature symfony/symfony#51741 [ObjectMapper] Object to Object mapper component (@soyuka)
Changelog (https://github.com/symfony/object-mapper/compare/v7.2.6...v7.3.0-BETA1)
One column per month.