Синтаксис атрибутов

    Синтаксис атрибутов состоит из нескольких частей. Во-первых, декларация атрибута начинается с символов #[ и заканчивается символом ]. Во-вторых, внутри конструкции перечисляют один или больше атрибутов, которые разделяют запятой. Названия атрибутов по аналогии с названиями классов указывают неполными, полными и абсолютными, как описывает раздел «Основы пространств имён». Аргументы атрибутов необязательны, но если аргументы указали, их заключают в круглые скобки (). Атрибуты принимают аргументы либо в виде конкретных литеральных значений, либо константных выражений. Аргументы разрешается записывать как позиционным, так и именованным синтаксисом.

    Когда API-интерфейс модуля Reflection запрашивает экземпляр класса атрибута, название атрибута трактуется как название запрашиваемого класса, а аргументы атрибута передаются в конструктор этого класса. Поэтому для каждого атрибута необходимо создавать класс.

    Пример #1 Синтаксис атрибутов

    <?php

    // a.php
    namespace MyExample;

    use     Attribute;

    #[    Attribute]
    class     MyAttribute
    {
    const     VALUE = 'value';

    private     $value;

    public function     __construct($value = null)
    {
    $this->value = $value;
    }
    }

    // b.php

    namespace Another;

    use     MyExample\MyAttribute;

    #[    MyAttribute]
    #[    \MyExample\MyAttribute]
    #[    MyAttribute(1234)]
    #[    MyAttribute(value: 1234)]
    #[    MyAttribute(MyAttribute::VALUE)]
    #[    MyAttribute(array("key" => "value"))]
    #[    MyAttribute(100 + 200)]
    class     Thing {}

    #[    MyAttribute(1234), MyAttribute(5678)]
    class     AnotherThing {}

    ?>

    Улучшение страницы

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 1 note

    up
    3
    yarns dot purport0n at icloud dot com
    10 months ago
    It wasn't obvious to me for a while but you can subclass attributes

    https://3v4l.org/TrMTe

    <?php

    #[Attribute(Attribute::TARGET_PROPERTY)]
    class     PropertyAttributes
    {
    public function     __construct(
    public readonly ?    string $name = null,
    public readonly ?    string $label = null,
    ) {}
    }

    #[    Attribute(Attribute::TARGET_PROPERTY)]
    class     IntegerPropertyAttributes extends PropertyAttributes
    {
    public function     __construct(
    ?    string $name = null,
    ?    string $label = null,
    public readonly ?    int $default = null,
    public readonly ?    int $min = null,
    public readonly ?    int $max = null,
    public readonly ?    int $step = null,
    ) {
    parent::__construct($name, $label);
    }
    }

    #[    Attribute(Attribute::TARGET_PROPERTY)]
    class     FloatPropertyAttributes extends PropertyAttributes
    {
    public function     __construct(
    ?    string $name = null,
    ?    string $label = null,
    public readonly ?    float $default = null,
    public readonly ?    float $min = null,
    public readonly ?    float $max = null,
    ) {
    parent::__construct($name, $label);
    }
    }

    class     MyClass
    {
    #[    IntegerPropertyAttributes('prop', 'property: ', 5, 0, 10, 1)]
    public     int $prop;
    }

    $refl = new ReflectionProperty('MyClass', 'prop');
    $attributes = $refl->getAttributes();

    foreach (    $attributes as $attribute) {
    var_dump($attribute->getName());
    var_dump($attribute->getArguments());
    var_dump($attribute->newInstance());
    }
    ?>
    ＋Добавить
    To Top