mj-zana / serialization

v2.19.0 2026-11-01 07:40 UTC

Requires

• php: ^8.5

Requires (Dev)

• mj-zana/core: ^2.0
• mj-zana/http: ^2.10
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5

Suggests

• mj-zana/core: To register the Serializer with SerializationServiceProvider
• mj-zana/http: To answer a DenormalizationException with a 422 and its field errors

MIT

• json
• serialization
• dto
• normalizer
• hydration
• zana

Published on Packagist.org on 2026-11-07 08:17 UTC

README

Convert objects to arrays and JSON, and hydrate typed objects from arrays and JSON through their constructors. No dependencies. Requires PHP 8.5 or later.

composer require mj-zana/serialization

Usage

use Zana\Serialization\Serializer;

$serializer = new Serializer();

$json = $serializer->serialize($patient);                       // object → JSON
$patient = $serializer->deserialize($json, Patient::class);     // JSON → object
$array = $serializer->normalize($patient);                      // object → array
$dto = $serializer->denormalize($request->getParsedBody(), RegisterPatient::class);

Normalizing uses public properties, enum values, ATOM dates and JsonSerializable. Hydrating fills constructor parameters by name:

• numeric strings become ints and floats, and "true" / "false" become booleans;
• enums are read from their value, or their name for unit enums;
• date strings become DateTimeImmutable;
• nested classes are hydrated recursively.

Attributes:

• #[SerializedName('height_cm')] renames a field;
• #[Ignore] leaves a property out;
• #[ListOf(Item::class)] hydrates each element of an array.

Every problem is reported at once:

try {
    $serializer->denormalize($input, RegisterPatient::class);
} catch (DenormalizationException $e) {
    $e->errors();   // ['name' => 'This field is missing.', 'items[1].quantity' => 'This value should be of type int.']
}

License

MIT — see LICENSE.