https://github.com/samdark/hydrator
Allows extracting data from objects and getting objects from data
https://github.com/samdark/hydrator
hydrator php
Last synced: about 2 months ago
JSON representation
Allows extracting data from objects and getting objects from data
- Host: GitHub
- URL: https://github.com/samdark/hydrator
- Owner: samdark
- License: mit
- Created: 2016-10-31T23:34:06.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2020-08-24T22:40:35.000Z (almost 5 years ago)
- Last Synced: 2025-04-02T08:09:59.687Z (2 months ago)
- Topics: hydrator, php
- Language: PHP
- Size: 22.5 KB
- Stars: 116
- Watchers: 9
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
Hydrator
========
Hydrator can be used for two purposes:
- To extract data from a class to be further stored in a persistent storage.
- To fill an object with data or create a new instance of a class filled with data.
In both cases it is saving and filling protected and private properties without calling
any methods which leads to ability to persist state of an object with properly encapsulated
data.
[](https://packagist.org/packages/samdark/hydrator)
[](https://packagist.org/packages/samdark/hydrator)
[](https://travis-ci.org/samdark/hydrator)
## Installation
The preferred way to install this package is through [composer](http://getcomposer.org/download/).
```
composer require --prefer-dist samdark/hydrator
```
## Usage
Consider we have a `Post` entity which represents a blog post. It has a title and a text. A unique id is generated to
identify it.
```php
class Post
{
private $id;
protected $title;
protected $text;
public function __construct($title, $text)
{
$this->id = uniqid('post_', true);
$this->title = $title;
$this->text = $text;
}
public function getId()
{
return $this->id;
}
public function getTitle()
{
return $this->title;
}
public function setTitle($title)
{
$this->title = $title;
}
public function getText()
{
return $this->text;
}
public function setText()
{
return $this->text;
}
}
```
Saving a post to database:
```php
$post = new Post('First post', 'Hell, it is a first post.');
$postHydrator = new \samdark\hydrator\Hydrator([
'id' => 'id',
'title' => 'title',
'text' => 'text',
]);
$data = $postHydrator->extract($post);
save_to_database($data);
```
Loading post from database:
```php
'id',
'title' => 'title',
'text' => 'text',
]);
$post = $postHydrator->hydrate($data, Post::class);
echo $post->getId();
```
Filling existing post object with data:
```php
$data = load_from_database();
$postHydrator = new \samdark\hydrator\Hydrator([
'title' => 'title',
'text' => 'text',
]);
$post = get_post();
$post = $postHydrator->hydrateInto($data, $post);
echo $post->getTitle();
```