5

No PHP 8, foi introduzido os attributos, que podem ser usados em classes ou métodos.

Exemplo:

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

Eu tenho algumas dúvidas a respeito disso:

  • Como faço para recuperar os valores desses atributos definidos na classe ou método?
  • Qual é a finalidade dos atributos? Atributos tem como finalidade alterar o comportamento do método/classe, ou são apenas dados extras?
6
  • 7
    pt.stackoverflow.com/q/484081/5878, duplicada?
    – Woss
    Commented 23/12/2020 às 12:32
  • @Woss concordo que parte da pergunta esteja duplicada, exceto referente à "como posso recuperar os valores definidos"? Commented 23/12/2020 às 13:05
  • 2
    Na outra é comentado que é via reflexão. Talvez possa solicitar ao autor da resposta para adicionar um exemplo lá para tornar a resposta mais completa (ou mesmo editar a resposta)
    – Woss
    Commented 23/12/2020 às 13:09
  • 4
    Concondo com ser duplicata, pedir por exemplos/esclarecimentos em comentário ou até colocar uma recompensa seria melhor que criar uma nova pergunta, pelo menos nesse caso
    – Costamilam
    Commented 24/12/2020 às 19:59
  • @Costamilam deixei em aberto para comunidade decidir. Se tiver um acréscimo na outra resposta, acho que vale a pena fechar essa mesmo. Commented 24/12/2020 às 21:39

1 Resposta 1

0

Qual é a finalidade dos atributos? Atributos tem como finalidade alterar o comportamento do método/classe, ou são apenas dados extras?

De acordo com a documentação:

Os atributos permitem adicionar informações de metadados estruturados e legíveis em declarações no código: classes, métodos, funções, parâmetros, propriedades e constantes de classe podem ser o destino de um atributo. Os metadados definidos pelos atributos podem ser inspecionados em tempo de execução usando as APIs do Reflection [...]

Sendo assim, os atributos não tem como finalidade de alterar o comportamento do método ou função, como no caso do Decorator do Python, mas sim, apenas adicionar metadados (informações extras).

Como faço para recuperar os valores desses atributos definidos na classe ou método?

Como dito na documentação, você precisa utilizar a Reflection API. A API Reflection permite você acessar informações de uma classe, função, método, parâmetros e etc.

Exemplo:

#[Attribute]
class Route
{
    public function __construct(protected string $path) {}

    public function getPath()
    {
        return $this->path;
    }
}

class UsuariosController
{
    #[Route("/usuarios")]
    public function index()
    {
    }
}

Você poderia recuperar essa informações assim:


$reflection_method = new ReflectionMethod(UsuariosController::class, 'index');

foreach ($reflection_method->getAttributes(Route::class) as $reflection_attribute) {

    $route = $reflection_attribute->newInstance();

    echo $route->getPath(), "\n"; // "/usuarios"
}

Observe que a classe que representa seu atributo personalizado precisa sempre conter a declaração #[Attribute] nas suas declarações.

Além disso, note que o método Reflection::getAttributes retorna um array de ReflectionAttribute. Isso porque você pode declarar mais de um atributo em uma classe ou método.

Veja:

class UsuariosController
{
   #[Route("/usuarios")]
   #[Route("/usuarios/listar")]
   #[RouteName("usuarios.listar")
   public function index() 
   {
      //
   }
}

Nessa pergunta, tem uma resposta que explica melhor a natureza dos atributos:

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .