大网数据广告活动
PHP 语言与运行手册

声明注解类

· 52CE 我爱测

建议为每个注解定义单独的类。在最简单的情况下,带有 #[Attribute] 声明的空类即可满足需求。可以使用 use 语句从全局命名空间导入该注解。

声明注解类

建议为每个注解定义单独的类。在最简单的情况下,带有 #[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] 声明的位掩码中使用 Attribute::IS_REPEATABLE flag 进行指定。

示例 #3 使用 IS_REPEATABLE 允许注解在声明中出现多次

<?php

namespace Example;

use Attribute;

#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_FUNCTION | Attribute::IS_REPEATABLE)]
class MyAttribute
{
}

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。