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

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

Когда 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
1 year ago
It wasn't obvious to me for a while but you can subclass attributeshttps://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