Ultimamente venho me deparando com alguns trechos de código que não consigo entender o propósito deles, geralmente são usados dentro de comentarios, 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?
ReflectionFunctionAbstract::getDocComment
para extrair essas informações e transformá-las em parte funcional do código. Atualmente, com na implementação do PHP 8, você também precisa usar Reflection para obter esses dados, porém sem a necessidade de fazer parser de string do docblock.@return self
é usado pelo editor de código para permitir o uso da função de autocompletar