Metadata
Miscellaneous
Other options of classes, properties and enums.
Every option is shown in each metadata source: choose the tab of the source you use. When a source cannot express an option, its tab says what is used instead.
Normalize as array
Section titled “Normalize as array”Normalizes objects of the class into an associative array (true) or into
stdClass (false). Overrides the
configuration option.
use TypeLang\Mapper\Mapping\NormalizeAsArray;
#[NormalizeAsArray(false)]final class User{ public string $name = 'Ada';}<?php
return [ App\User::class => [ 'normalize_as_array' => false, ],];{ "App\\User": { "normalize_as_array": false }}App\User: normalize_as_array: falseApp\User: normalize_as_array: false$mapper->normalize(new User()); // (object) ['name' => 'Ada']Default value
Section titled “Default value”The value of a missing field. A property without a default value is required.
final class User{ public string $name; public string $role = 'user';}<?php
return [ App\User::class => [ 'properties' => [ 'role' => [ 'default' => 'user', ], ], ],];{ "App\\User": { "properties": { "role": { "default": "user" } } }}App\User: properties: role: default: userApp\User: properties: role: default: user$mapper->denormalize(['name' => 'Ada'], User::class);// User { name: 'Ada', role: 'user' }$mapper->denormalize(['role' => 'admin'], User::class);// throws InvalidValueException: $.name: Required field "name" is missingValue aliases
Section titled “Value aliases”Other values accepted for a case of a backed enum, such as old values. Normalization always gives the value of the case.
use TypeLang\Mapper\Mapping\MapAlias;
enum Status: string{ #[MapAlias(['enabled', 'on'])] case Active = 'active';
case Blocked = 'blocked';}<?php
return [ App\Status::class => [ 'aliases' => [ 'enabled' => 'active', 'on' => 'active', ], ],];{ "App\\Status": { "aliases": { "enabled": "active", "on": "active" } }}App\Status: aliases: enabled: active 'on': activeApp\Status: aliases: enabled: active on: active$mapper->denormalize('on', Status::class); // Status::Active$mapper->normalize(Status::Active); // 'active'