mouf / tdbm-hydrator
A PHP hydrator allowing easy mapping between an array and an object.
Installs: 29 727
Dependents: 1
Suggesters: 0
Security: 0
Stars: 1
Watchers: 8
Forks: 0
Open Issues: 2
Requires
- php: >=7.0
- danielstjules/stringy: ^2.3.2
Requires (Dev)
- phpunit/phpunit: ^5.4.6
- satooshi/php-coveralls: ~1.0
This package is auto-updated.
Last update: 2024-10-15 05:40:27 UTC
README
About the TDBM hydrator
This package contains an hydrator. An hydrator is a class that takes an array in parameter and maps it to an object (calling the appropriate getters and setters).
Unlike most existing hydrators that need an object instance to be filled, the tdbm-hydrator package can (optionally) create a new object instance. This is very useful when you have big constructors with lots of parameters to fill from the array, which happen often if you use TDBM.
Note that this package is completely standalone and does not need TDBM or Mouf to run. Still, this hydrator is known to work very well with TDBM generated beans (hence the name).
Installation
composer require mouf/tdbm-hydrator
Usage
Let's assume you have a simple Product
class:
class Product { private $name; private $price; private $inStock; public function __construct(string $name, float $price) { $this->name = $name; $this->price = $price; } public function setName(string $name) { $this->name = $name; } public function setPrice(float $price) { $this->price = $price; } public function setInStock(bool $inStock) { $this->inStock = $inStock; } // Let's assume we have getters too... }
Now, I have this PHP array I want to turn into an object:
$productAsArray = [ 'name' => 'My product', 'price' => '99', 'in_stock' => true ]
Creating a new hydrated object
I can create an object ex-nihilo, using the following code:
$hydrator = new TdbmHydrator(); $product = $hydrator->hydrateNewObject([ 'name' => 'My product', 'price' => '99', 'in_stock' => true ], Product::class);
Notice that:
- the
TdbmHydrator
will map each item of the array to the constructor arguments or the setters - the
TdbmHydrator
can sort out differences between camel-case and underscored names (for instance, it can mapin_stock
tosetInStock()
)
Hydrating an existing object
I can also fill an existing object with values from an array. In this case, only setters are called:
$product = new Project('My product', 99); $hydrator->hydrateObject([ 'in_stock' => true ], $product);