Syntaxe des attributs

La syntaxe des attributs consiste en plusieurs composants clés. Une déclaration d'attribut commence par #[ et se termine par ]. À l'intérieur, un ou plusieurs attributs peuvent être listés, séparés par des virgules. Le nom de l'attribut peut être non qualifié, qualifié, ou complètement qualifié, comme décrit dans Utilisation de base des espaces de noms. Les arguments de l'attribut sont optionnels et sont placés entre parenthèses (). Les arguments peuvent uniquement être des valeurs littérales ou des expressions constantes. La syntaxe des arguments positionnels et nommés est supportée.

Les noms d'attributs et leurs arguments sont résolus vers une classe, et les arguments sont passés à son constructeur lorsqu'une instance de l'attribut est demandée via l'API de réflexion. Il est donc recommandé d'introduire une classe pour chaque attribut.

Exemple #1 Syntaxe des attributs

<?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
{
}