注解语法包含以下几部分。
首先,注解声明总是以 #[
开头,以
]
结尾来包围。
内部则是一个或以逗号包含的多个注解。
注解的名称按 使用命名空间:基础
章节中描述,可以是非限定、限定、完全限定的名称。
注解的参数是可以选的,以常见的括号()
包围。
注解的参数可以是字面值或者常量表达式。
它同时接受位置参数和命名参数两种语法。
通过反射 API 请求注解实例时,注解的名称会被解析到一个类,注解的参数则传入该类的构造器中。 因此每个注解都需要引入一个类。
Example #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
{
}