La sintaxis de atributos consta de varios componentes clave. Una declaración
de atributo comienza con #[
y termina con
]
. Dentro de esta, se pueden listar uno o más atributos,
separados por comas. El nombre del atributo puede ser no cualificado, cualificado
o totalmente cualificado, como se describe en Uso de los espacios de nombres: lo básico.
Los argumentos para el atributo son opcionales y se encierran entre paréntesis
()
. Los argumentos solo pueden ser valores literales o expresiones
constantes. Se admite la sintaxis de argumentos posicionales y nombrados.
Los nombres de los atributos y sus argumentos se resuelven en una clase, y los argumentos se pasan a su constructor cuando se solicita una instancia del atributo a través de la API de Reflection. Por lo tanto, se recomienda crear una clase para cada atributo.
Ejemplo #1 Sintaxis de atributos
<?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
{
}