Serializard
Serializard is a library for (un)serialization of data of any complexity. Its main focus is to give user as much flexibility as possible by delegating the (un)serialization logic to the programmer to encourage good object design and only supervising the process hiding the unpleasant details about it.
Installation
This library is available on Composer/Packagist as thunderer/serializard.
Usage
Let's consider a simple User class with two properties and some setup code:
final class User
{
private $id;
private $name;
public function __construct(int $id, string $name) { /* ... */ }
public function getId() { return $this->id; }
public function getName() { return $this->name; }
}
$user = new User(1, 'Thomas');
$formats = new FormatContainer();
$formats->add('json', new JsonFormat());
$hydrators = new FallbackHydratorContainer();
$normalizers = new FallbackNormalizerContainer();
$serializard = new Serializard($formats, $normalizers, $hydrators);
Serialization
Serialization is controlled by registering handlers used in normalization phase:
$normalizers->add(User::class, function(User $user) {
return [
'id' => $user->getId(),
'name' => $user->getName(),
];
});
$result = $serializard->serialize($user, 'json');
// result is {"id":1,"name":"Thomas"}
Unserialization
Unserialization can be controlled by registering callables able to reconstruct objects from data parsed from input text:
$hydrators->add(User::class, function(array $data) {
return new User($data['id'], $data['name']);
});
$json = '{"id":1,"name":"Thomas"}';
$user = $serializard->unserialize($json, User::class, 'json');
Formats
- JSON in
JsonFormatconverts objects to JSON, - Array in
ArrayFormatjust returns object graph normalized to arrays of scalars, - YAML in
YamlFormatconverts objects to YAML (usessymfony/yaml), - XML in
XmlFormatconverts objects to XML (usesext-dom).
License
See LICENSE file in the main directory of this library.
![[sCRiPTz-TEAM]](https://avatars.githubusercontent.com/u/533180?v=4&s=60)
3 Dec 31, 2021
155 Sep 27, 2022
2 Jul 31, 2022
1.3k Dec 22, 2022
680 Jan 4, 2023
6 Nov 3, 2022
146 Sep 28, 2022
4 Sep 22, 2022
1 Feb 1, 2022
31 Jun 25, 2021
21k Jan 1, 2023
1.6k Dec 23, 2022
642 Dec 28, 2022
441 Dec 11, 2022
844 Nov 17, 2022
0 Dec 13, 2021
1 Jul 16, 2022
10 Aug 18, 2022
19 Feb 20, 2022
3.5k Jan 8, 2023
191 Dec 19, 2022
10.3k Jan 1, 2023
45 Jan 13, 2022
1.2k Dec 31, 2022
1 Jan 19, 2022
727 Dec 21, 2022
2 Jun 19, 2022
3 Oct 16, 2021
828 Dec 15, 2022