eventsauce/object-hydrator

Fixed

• PHP 8.5 support
• Align serialize with hydrator picking up nested DTOs when #93 (by @WyriHaximus)

Added

• Be able to filter out NULL values.
• Default caster for DateTimeZone

Fixed

• Be able to assign more casters to promoted properties

Set correct release version

Fixes

• Fix PHP 8.4 deprecations

Added

• Added interface for custom constructor resolution

Fixes

• Skip parsing of closure use statements

Improved

• Default to empty array in default serializer repository
• Allow skipping public method serialization
• Allow hydrating an array of enums.
• Serialize unit enums to their name.

Fixed

• [Regression] Casters returning null causes problem for hydrator enums.

Improved

• Naive property type resolving now handles a bunch more cases.

Fixed

• Only try to resolve one property from the docblock to prevent parsing error (#50)

Added

• This is not a joke release.
• MapperSettings can now also be specified using an interface.

Added

• Added ability to define polymorhic object mapping (#29)

Fixed

• Add mixed as native type in NaivePropertyTypeResolver (#40)

Fixed

• Ensure generic template is of object type (#36)
• Prevent method name collisions in case SomeThing and Some\Thing both exist

Fixed

• Corrected @template generic usage for generated hydrator
• Prevented exception when scalar type is resolved from a docblock

Added

• Added ability to omit all public method from serialization.
• Added ability to omit all public properties from serialization.
• Added ability to omit specific public methods and properties from serialization.

• Functionally equivalent to 0.5.5, stable release.

• Support nullable enum properties #28

Fixed

• Fix typo in PHPDoc parser regex pattern #27

Fixed

• Fix cache keys colliding when using multiple casters without options #26

Fixed

• Ignore use function/const statements when resolving the use statement map (#25)

Fixed

• Handle omission of data for nullable parameters and parameters with a default

Added

• Expose missing fields in UnableToHydrate exception.
• Added information about which property caused hydration failure.

Fixed

• Prevent type-error when casting null values for nullable properties (#23)

Fixed

• Fixed phpstan template notations.

Added

• The CastToDateTimeImmutable caster now supports setting a timezone.

Deprecations

• The ObjectHydrator class was deprecated, use ObjectMapperUsingReflection and hint against the new ObjectMapper interface.
• The ListOfObjects class was deprecated, use the IterableList object instead.
• The KeyFormattingWithoutConversion class was deprecated, use the KeyFormatterWithoutConversion class instead.

Breaking Changes

• The ObjectHydrator class was converted into an interface named ObjectMapper, the main implementation is ObjectMapperUsingReflection.
• The PropertyDefintion class was renamed to PropertyHydrationDefinition to be symmetrical with the new PropertySerializationDefinition.
• The DefinitionProvider::provideDefinition method was deprecated in favour of the new provideHydrationDefinition for symmetry with provideSerializationDefinition.
• The KeyFormatter interface was changed by adding a keyToPropertyName method, needed for serialization.
• The ObjectHydrator::hydrateObjects return type class was renamed from ListOfObjects to IterableList.

Added

• The ObjectMapper interface was introduced, which represents both generated and reflection based mappers.
• [Major Feature] Serialization was added to the main ObjectHydrator interface.
• Array hydration now also has rudimentary support for docblock type hints (@param Type[] $name, @param array<Type> $name, @param array<string, Type> $name).

Fixed

• Allow same hydrator to be used with different constructor options.

Added

• Added ability to define nested input (#12)

Added

• Added hydrateObjects; a way to hydrate a list of objects in one go

Added

• Initial implementation of the object hydrator