アトリビュートの文法は、いくつかの重要な要素で構成されています。
アトリビュートの宣言は #[ で始まり、] で終わります。
その内部には、1つ以上のアトリビュートをカンマで区切って並べることができます。
アトリビュート名は、名前空間の基礎 で説明されているように、
非修飾名、修飾名、または完全修飾名にすることができます。
アトリビュートへの引数はオプションで、括弧 () で囲みます。
引数にはリテラル値または定数式のみを指定できます。
位置引数と名前付き引数の両方の構文がサポートされています。
アトリビュート名とその引数はクラスに解決され、 リフレクション API を介してアトリビュートのインスタンスが要求されると、 引数がそのコンストラクタに渡されます。 したがって、各アトリビュートに対してクラスを導入することをお勧めします。
例1 アトリビュートの文法
<?php
// a.php
namespace MyExample;
use Attribute;
#[Attribute]
class MyAttribute
{
const VALUE = 'value';
private $value;
public function __construct($value = null)
{
$this->value = $value;
}
}
// b.php
namespace Another;
use MyExample\MyAttribute;
#[MyAttribute]
#[\MyExample\MyAttribute]
#[MyAttribute(1234)]
#[MyAttribute(value: 1234)]
#[MyAttribute(MyAttribute::VALUE)]
#[MyAttribute(array("key" => "value"))]
#[MyAttribute(100 + 200)]
class Thing
{
}
#[MyAttribute(1234), MyAttribute(5678)]
class AnotherThing
{
}