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).