声明注解类
虽然没有严格要求，推荐为每个注解创建一个实际的类。
在这个最简单的例子中，通过 use 语法从全局命名空间引入 #[Attribute] 注解所需要全空的类。
示例 #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] 声明中设置字节位掩码。
示例 #3 使用 IS_REPEATABLE 允许注解在声明中出现多次
<?php
namespace Example;
use Attribute;
#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_FUNCTION | Attribute::IS_REPEATABLE)]
class MyAttribute
{
}
add a note
User Contributed Notes 1 note
esdras-schonevald ¶
5 months ago
#! Require PHP >= 8.0
#! This is a Sample
<?php
declare(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"
备份地址：http://www.lvesu.com/blog/php/language.attributes.classes.php