Объявление классов атрибутов
Хотя и нет строго требования, лучше выполнять рекомендацию — создавать класс для каждого атрибута.
В самом простом случае необходимо создать пустой класс с атрибутом #[Attribute], класс которого
можно импортировать из глобального пространства имён через оператор use.
Пример #1 Простой класс с атрибутом
<?php
namespace Example;
use Attribute;
#[Attribute]
class MyAttribute
{
}
Чтобы ограничить типы сущностей, на которые можно будет нацелить атрибут, необходимо
в момент объявления атрибута #[Attribute] передать в качестве первого аргумента битовую маску.
Пример #2 Спецификация указания целей, которым атрибут может быть присвоен
<?php
namespace Example;
use Attribute;
#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_FUNCTION)]
class MyAttribute
{
}После такого декларирования попытка присвоить атрибут MyAttribute другой сущности, тип которой отличается от метода или функции, приведёт к выбрасыванию исключения при вызове ReflectionAttribute::newInstance().
Можно указать следующие цели:
Attribute::TARGET_CLASSAttribute::TARGET_FUNCTIONAttribute::TARGET_METHODAttribute::TARGET_PROPERTYAttribute::TARGET_CLASS_CONSTANTAttribute::TARGET_PARAMETERAttribute::TARGET_ALL
По умолчанию атрибут можно присвоить сущности только один раз. Присвоить
одинаковые атрибуты одной сущности можно, если объявить атрибут #[Attribute]
с флагом Attribute::IS_REPEATABLE в битовой маске.
Пример #3 Применение константы IS_REPEATABLE при объявлении атрибута для разрешения его многократного присваивания
<?php
namespace Example;
use Attribute;
#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_FUNCTION | Attribute::IS_REPEATABLE)]
class MyAttribute
{
}
add a note
