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: