Download the PHP package stratadox/hydrator without Composer
On this page you can find all versions of the php package stratadox/hydrator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package hydrator
Hydrator
Lightweight hydrators, usable for various hydration purposes. Hydrate away!
Installation
Install with composer:
composer require stratadox/hydrator
What is this?
The Hydrator
package exists in the context of object deserialization.
It is useful when loading objects from a data source.
To hydrate an object, means to assign values to its properties.
A Hydrator
populates the
fields of other objects.
Hydration generally works in tandem with Instantiation
;
the process of creating empty objects.
How to use this?
Basic Objects
The most basic usage looks like this:
The default hydrator requires the hydrated object to have access to all of its own properties.
When that's not the case, for instance when some properties are private to the
parent, a reflective
hydrator is available:
Collection Objects
To hydrate collection objects, the Hydrator
package provides either a
MutableCollectionHydrator
, suitable for most collection classes:
The MutableCollectionHydrator
hydrates by mutating the collection object.
Naturally, this will not work when your collections are immutable,
in which case the ImmutableCollectionHydrator
should be used instead.
What else can it do?
The hydrators can be decorated to extend their capabilities.
Mapping
To transform the input data with hydration mapping,
the Mapping
decorator can be used:
Observing
The hydration process can be observed in two ways: before or after hydrating.
To observe the hydration process right before hydration begins, use:
To observe the hydration process right after hydration is done, use:
The observer must be a HydrationObserver
.
It will receive both the object instance and the input data.
All versions of hydrator with dependencies
stratadox/hydrator-contracts Version ^0.8
stratadox/instantiator Version ^0.2
stratadox/hydration-mapping-contracts Version ^0.4