PHP: Sintaxe de Atributo

Sintaxe de Atributo

A sintaxe de atributo consiste em vários componentes-chave. Uma declaração de atributo começa com #[ e termina com ]. Dentro, um ou mais atributos podem ser listados, separados por vírgulas. O nome do atributo pode ser não qualificado, qualificado, ou totalmente qualificado, conforme descrito em Usando Namespaces Básicos. Argumentos para o atributo são opcionais e colocados entre parênteses (). Argumentos podem ser apenas valores literais ou expressões constantes. Tanto a sintaxe de argumento posicional quanto a de argumento nomeado são suportadas.

Nomes de atributos e seus argumentos são resolvidos para uma classe, e os argumentos são passados para seu construtor quando uma instância do atributo é solicitada por meio da API Reflection. Portanto, é recomendado introduzir uma classe para cada atributo.

Exemplo #1 Sintaxe de Atributo

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

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicionar nota

Notas de Usuários 1 note

down

yarns dot purport0n at icloud dot com ¶

1 year ago

It wasn't obvious to me for a while but you can subclass attributeshttps://3v4l.org/TrMTe<?php#[Attribute(Attribute::TARGET_PROPERTY)]class PropertyAttributes {    public function __construct(        public readonly ?string $name = null,        public readonly ?string $label = null,    ) {} }#[Attribute(Attribute::TARGET_PROPERTY)]class IntegerPropertyAttributes extends PropertyAttributes {    public function __construct(        ?string $name = null,        ?string $label = null,        public readonly ?int $default = null,        public readonly ?int $min = null,        public readonly ?int $max = null,        public readonly ?int $step = null,    ) {        parent::__construct($name, $label);    } }#[Attribute(Attribute::TARGET_PROPERTY)]class FloatPropertyAttributes extends PropertyAttributes {    public function __construct(        ?string $name = null,        ?string $label = null,        public readonly ?float $default = null,        public readonly ?float $min = null,        public readonly ?float $max = null,    ) {        parent::__construct($name, $label);    } }class MyClass {     #[IntegerPropertyAttributes('prop', 'property: ', 5, 0, 10, 1)]     public int $prop; }$refl = new ReflectionProperty('MyClass', 'prop');$attributes = $refl->getAttributes();    foreach ($attributes as $attribute) {       var_dump($attribute->getName());       var_dump($attribute->getArguments());       var_dump($attribute->newInstance());    }?>

＋adicionar nota