Skip to main content

O que sao Atributos no PHP? (Annotations/Attributes/Decorators)

Ultimamente venho me deparando com alguns trechos de código que Nao consigo entender o proposito deles, geralmente são usados dentro de commentaries, o que não faz muito sentido pra mim.

Fazendo uma pesquisa sobre esse assunto cai no termo atributos, mas mesmo depois disso não consegui entender bem a razão deles. O uso do termo atributos pra se referir a variáveis também atrapalha bastante na busca.

No site oficial do PHP, além de outras definições, entendi que não é algo exclusivo do PHP e que na verdade eh bem comum.

Similar concepts exist in other languages named Annotations in Java, Attributes in C#, C++, Rust, Hack and Decorators in Python, JavaScript.

Um exemplo de código:

/**
* @Route("/api/posts/{id}", methods={"GET", "HEAD"})
*/
class User
{

Que na versao 8.0 do PHP fica

#[Route("/api/posts/{id}", methods: ["GET", "HEAD"])]
class User
{

Ou ate mesmo na extensão que eu uso pra gerar os getters e setters automaticamente:

/**
* Set the value of name
*
* @return  self
*/ 
public function setName($name)
  {
      $this->name = $name;

      return $this;
  }

Nesse último caso eu sempre acabo apagando esses atributos.

Qual a função deles? eles são necessários/fundamentais ou soh eh algo a mais pra ajudar na compilação/manutenção do código? Devo sempre os utilizar?

Vrrl
  • 133
  • 7