Attribute Reader

This reader is used to read PHP attributes to construct metadata.

To create it, it is enough to instantiate AttributeReader class:

use TypeLang\Mapper\Mapper;
use TypeLang\Mapper\Platform\StandardPlatform;
use TypeLang\Mapper\Mapping\Reader\AttributeReader;

$reader = new AttributeReader();

$mapper = new Mapper(
    [[[platform: new StandardPlatform(|standard-platform.html]]]
        meta: $reader,
        // ...
    ),
);

After this, you will have access to the description of the types in the PHP Attributes:

use TypeLang\Mapper\Mapping\MapType;

final class UserInfo
{
    public function __construct(
        #[MapType('non-empty-string')]
        public mixed $name,
    ) {}
}

By default, it supports the following attributes:

#[DiscriminatorMap] - Allows to specify a discriminator map for a class or interface
#[MapName] - Allows to specify public aliases for properties
#[MapType] - Allows to specify property type and type strictness
#[NormalizeAsArray] - Allows to specify class normalization rules (into an associative array or object)
#[OnTypeError] - Allows to customize the type error in a property
#[OnUndefinedError] - Allows to customize the "undefined property" error in a property
#[SkipWhen] - Allows to specify an expression that will exclude a property during normalization
#[SkipWhenEmpty] - Allows to specify a "when empty" rule that will exclude a property during normalization
#[SkipWhenNull] - Allows to specify a "when null" rule that will exclude a property during normalization

If you need to supplement metadata from another reader, you should specify this explicitly using $delegate argument:

use TypeLang\Mapper\Mapping\Reader\AttributeReader;

$reader = new AttributeReader(
    delegate: new AnotherExampleReader(),
);

06 November 2025