Recupera los atributos de una clase

# ReflectionClass::getAttributes

(PHP 8)

ReflectionClass::getAttributes — Recupera los atributos de una clase

### Descripción

public function ReflectionClass::getAttributes(?string `$name` = `null`, int `$flags` = 0): array

Devuelve todos los atributos declarados en esta clase en forma de un array de objetos ReflectionAttribute.

### Parámetros

`name`
  Filtrar los resultados para incluir únicamente las instancias de ReflectionAttribute para los atributos correspondientes a este nombre de clase.
`flags`
  Flags para determinar cómo filtrar los resultados, si `name` es proporcionado. El valor por omisión es `0` que solo retornará los resultados para los atributos que son de la clase `name`. La única otra opción disponible es utilizar `ReflectionAttribute::IS_INSTANCEOF`, que utilizará `instanceof` para el filtrado.

### Valores devueltos

Un array de atributos, en forma de objetos de tipo ReflectionAttribute.

### Ejemplos

Ejemplo #1 Uso básico de ReflectionClass::getAttributes()

    <?php
    #[Attribute]
    class Fruit {
    }

    #[Attribute]
    class Rouge {
    }

    #[Fruit]
    #[Rouge]
    class Pomme {
    }

    $class = new ReflectionClass('Pomme');
    $attributes = $class->getAttributes();
    print_r(array_map(fn($attribute) => $attribute->getName(), $attributes));
    ?>

El ejemplo anterior mostrará:

    Array
    (
        [0] => Fruit
        [1] => Rouge
    )

Ejemplo #2 Filtrar los resultados por un nombre de clase

    <?php
    #[Attribute]
    class Fruit {
    }

    #[Attribute]
    class Rouge {
    }

    #[Fruit]
    #[Rouge]
    class Pomme {
    }

    $class = new ReflectionClass('Pomme');
    $attributes = $class->getAttributes('Fruit');
    print_r(array_map(fn($attribute) => $attribute->getName(), $attributes));
    ?>

El ejemplo anterior mostrará:

    Array
    (
        [0] => Fruit
    )

Ejemplo #3 Filtrar los resultados por nombre de clase, con herencia

    <?php
    interface Couleur {
    }

    #[Attribute]
    class Fruit {
    }

    #[Attribute]
    class Rouge implements Couleur {
    }

    #[Fruit]
    #[Rouge]
    class Pomme {
    }

    $class = new ReflectionClass('Pomme');
    $attributes = $class->getAttributes(Couleur::class, ReflectionAttribute::IS_INSTANCEOF);
    print_r(array_map(fn($attribute) => $attribute->getName(), $attributes));
    ?>

El ejemplo anterior mostrará:

    Array
    (
        [0] => Rouge
    )

### Ver también

- ReflectionClassConstant::getAttributes() - Verifica los atributos
- ReflectionFunctionAbstract::getAttributes() - Devuelve los atributos
- ReflectionParameter::getAttributes() - Devuelve los atributos
- ReflectionProperty::getAttributes() - Devuelve los atributos

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open