-2

Estou usando atributos do PHP 8, a documentação desse recurso ainda é rudimentar, só contém exemplos de código e a api não está documentada então estou experimentando o uso do recurso.

class MeuAtributo {}

#[MeuAtributo]
class Teste {}

$reflection = new ReflectionClass(Teste::class);
$attributes = $reflection->getAttributes();
var_dump($attributes[0]->newInstance());

Ao executar esse código o seguinte erro ocorre na chamada de newInstance():

Attempting to use non-attribute class "MeuAtributo" as attribute in /code/index.php:10
  • O que é a classe de atributo mencionada na mensagem?
  • Como corrigir esse erro?
9
  • Relacionada: O que são atributos no PHP? e Como funcionam os atributos no PHP 8 Commented 26/01/2021 às 13:03
  • 3
    Geralmente, eu costumo fechar como erro de digitação perguntas que tenham algo parecido como "esqueci de colocar X" por desatenção ou ter deixado passar um detalhe despercebido da documentação, ou mesmo "erro de sintaxe". Aqui no stackoverflow é interessante que as perguntas estejam formuladas de maneira a ajudar não só a si próprio, mas também os demais usuários. Ao meu ver, faltou atenção na hora de implementar o Attribute. Commented 26/01/2021 às 14:13
  • 1
    Esqueci aquela hora de deixar o link da documentação para ajudar um pouco. Ainda está em inglês, somente. Commented 26/01/2021 às 17:10
  • Esse recurso de Reflection é novo no PHP ou sempre teve? Se for que nem o do Java, é desnecessário em 99% dos casos, nem aconselho a aprender muito, só a saber que existe. A maioria dos casos que achar que dá pra usar vai ser melhor fazer sem. E se for que nem o do Java ainda por cima é lerdo. Just saying
    – Piovezan
    Commented 26/01/2021 às 19:16
  • @Piovezan Reflection do PHP existe desde 2004 com a versão 5. Não tenho informações sobre performance. mas sei que alguns frameworks usam (em injeção de dependências). Especificamente para a parte de atributos/annotations reflexão é a única forma de acessar esse recurso (em C# também) Commented 26/01/2021 às 19:18

1 Resposta 1

0

TD; DR:

Para definir uma classe de atributo classe adicione #[Attribute] antes da classe:

namespace App;

use Attribute;

#[Attribute]
class MeuAtributo {}

O use é necessário somente quando a classe usa namespace, como nesse exemplo.


Entendendo classe de atributos

A definição de classes de atributos está descrita nessa página do manual (sem tradução). Ainda assim acho útil fazer um paralelo com linguagens que já utilizam esse recurso, como C# por exemplo, pois falta descrição conceitual do recurso.

Os atributos fornecem um método eficiente de associação de metadados, ou informações declarativas, ao código (classes, métodos e propriedades, funções, constantes de classe, parâmetros). Após um atributo ser associado a uma entidade de programa, o atributo poderá ser consultado no tempo de execução usando uma técnica chamada reflexão.

Os atributos têm as seguintes propriedades:

  • Os atributos adicionam metadados ao seu programa. Os metadados são informações sobre os tipos definidos em um programa. Você pode adicionar atributos personalizados para especificar qualquer informação adicional necessária.
  • Você pode aplicar um ou mais atributos a classes, métodos e propriedades, etc.
  • Os atributos podem aceitar argumentos.
  • Seu programa pode examinar seus próprios metadados ou os metadados em outros programas usando reflexão.

Uma classe de atributo é uma classe que deriva direta ou indiretamente da classe Attribute, o que faz com que a identificação das definições de atributo nos metadados seja rápida e fácil. Suponha que você queira marcar tipos com o nome do programador que escreveu o tipo. Você pode definir uma classe de atributos Author personalizada.

Na prática

Attribute tem um parâmetro opcional para limitar onde essa classe de atributo pode ser utilizada, esse argumento aceita uma combinação das constantes usando | (operador de bit "OU"):

Attribute::TARGET_ALL;
Attribute::TARGET_CLASS;
Attribute::TARGET_CLASS_CONSTANT;
Attribute::TARGET_FUNCTION;
Attribute::TARGET_METHOD;
Attribute::TARGET_PARAMETER;
Attribute::TARGET_PROPERTY;

Por exemplo:

#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_FUNCTION)]
class Exemplo {}

Permitirá que a classe de atributo Exemplo seja utilizada apenas como atributos de métodos e funções.

Sobre os erros

O erro destacado na verdade é uma exceção e pode ser capturada com try/catch. Ocorre quando há algum problema com a implementação, seja falta do atributo (o erro apontado na pergunta) ou uma restrição de uso (descrita acima).

3
  • Acho que faltou o use Attribute;, se não me engano, precisa dele
    – Costamilam
    Commented 27/01/2021 às 20:29
  • @Costamilam só precisaria do use se o arquivo usasse namespace, como nesse exemplo não foi usado ele não é necessário Commented 27/01/2021 às 20:33
  • Se quiser, pode adicionar isso a resposta, pra ficar mais completo
    – Costamilam
    Commented 27/01/2021 às 22:11

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