Download the PHP package jameshalsall/object-hydrator without Composer

Object Hydrator

A simple object hydrator using reflection for constructor or setter based injection.

The hydrator takes an array of raw data and hydrates one or multiple objects of a given class with that data.

Usage

There are two main types of hydrator provided, the ObjectConstructorFromArrayHydrator and the ObjectSetterFromArrayHydrator allowing you to hydrate via a constructor or via setters, respectively.

Constructor hydration

If your object uses constructor injection then you can hydrate your objects using an instance of ObjectConstructorFromArrayHydrator.

Example:

The Person\Employee class would look as follows:

Setter hydration

If your object uses setter injection then you can hydrate your objects using an instance of ObjectSetterFromArrayHydrator.

Example:

The Person\Employee class would look as follows:

With the setter hydrator you can pass existing objects to the hydrator as well, rather than class names:

Hydrating collections

Sometimes you may have an array of arrays, each representing a model's raw data. You can hydrate these in one method call, for example:

NOTE: You cannot pass an object to the hydrateCollection method, it must be either a callable or a string containing the FQCN.

Callable class names

When hydrating an object the first argument that you pass to the hydrate or hydrateCollection method is the fully qualified class name (FQCN) that you wish to create an instance of. Instead of a FQCN you can pass a callable. The callable will receive the raw data ($data) that you pass as the second argument.

Example:

Roadmap

• Add factory to improve readability of instantiating hydrators
• Explore option of adding support for the hydration of nested objects
• Allow instances of objects to be passed to the hydrator instead of class names