PHP: 声明注解类

声明注解类

建议为每个注解定义单独的类。在最简单的情况下，带有 #[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
{
}

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 1 note

down

esdras-schonevald ¶

3 years ago

#! Require PHP >= 8.0#! This is a Sample<?phpdeclare(strict_types = 1);#[Attribute]class Foo{    function __construct(){        echo "Running " . __METHOD__ . PHP_EOL;    }}#[Attribute(Attribute::TARGET_CLASS|Attribute::IS_REPEATABLE)]class Bar {    function __construct(?string ...$args){        echo "Running " . __METHOD__ ,            " args: " . implode(", ", $args) . PHP_EOL;    }}#[Attribute(Attribute::TARGET_ALL)]class Baz {    function __construct(        private string $parameter    ){        echo "Running " . __METHOD__ ,            " arg: " . $this->parameter . PHP_EOL;    }}#[Foo]                                      // [0]#[Bar]                                      // [1]#[Bar("Banana")]                            // [2]#[Bar("Banana", "Apple", "Lemon", "Grape")] // [3]#[Baz("The Only One")]                      // [4]class Qux{}// Getting class attribute with ReflectionClass$ref    =   new ReflectionClass(Qux::class);$attrs  =   $ref->getAttributes(); // Array of attributes$attrs[0]->newInstance(); // "Running Foo::__construct"$attrs[1]->newInstance(); // "Running Bar::__construct args: "$attrs[2]->newInstance(); // "Running Bar::__construct args: Banana"$attrs[3]->newInstance(); // "Running Bar::__construct args: Banana, Apple, Lemon, Grape"$attrs[4]->newInstance(); // "Running Baz::__construct arg: The Only One"