建议为每个注解定义单独的类。在最简单的情况下,带有 #[Attribute] 声明的空类即可满足需求。可以使用
use 语句从全局命名空间导入该注解。
示例 #1 简单的 Attribute 类
<?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 flag 进行指定。
示例 #3 使用 IS_REPEATABLE 允许注解在声明中出现多次
<?php
namespace Example;
use Attribute;
#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_FUNCTION | Attribute::IS_REPEATABLE)]
class MyAttribute
{
}