Edit Report a Bug

    ReflectionParameter::getAttributes

    (PHP 8)

    ReflectionParameter::getAttributes — Получает атрибуты

    Описание

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

    Возвращает все атрибуты, объявленные в этом параметре, в виде массива ReflectionAttribute.

    Список параметров

    name

    Фильтрация результатов, чтобы оставить только экземпляры ReflectionAttribute для атрибутов, соответствующих этому имени класса.

    flags

    Флаги для определения способа фильтрации результатов, если указан параметр name.

    По умолчанию значение 0, которое возвращает результаты только для атрибутов, относящихся к классу name.

    Единственным доступным вариантом является использование константы ReflectionAttribute::IS_INSTANCEOF, которая вместо этого будет использовать для фильтрации instanceof.

    Возвращаемые значения

    Массив атрибутов в виде объекта ReflectionAttribute.

    Примеры

    Пример #1 Простой пример

    <?php
    #[Attribute]
    class     Fruit {
    }

    #[    Attribute]
    class     Red {
    }

    function     fruitBasket(
    #[    Fruit]
    #[    Red]
    string $apple
    ) { }

    $reflection = new ReflectionFunction('fruitBasket');
    $parameter = $reflection->getParameter('apple');
    $attributes = $parameter->getAttributes();
    print_r(array_map(fn($attribute) => $attribute->getName(), $attributes));
    ?>

    Результат выполнения приведённого примера: 

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

    Пример #2 Фильтрация результатов по имени класса

    <?php
    #[Attribute]
    class     Fruit {
    }

    #[    Attribute]
    class     Red {
    }

    function     fruitBasket(
    #[    Fruit]
    #[    Red]
    string $apple
    ) { }

    $reflection = new ReflectionFunction('fruitBasket');
    $parameter = $reflection->getParameter('apple');
    $attributes = $parameter->getAttributes('Fruit');
    print_r(array_map(fn($attribute) => $attribute->getName(), $attributes));
    ?>

    Результат выполнения приведённого примера: 

    Array
(
    [0] => Fruit
)

    Пример #3 Фильтрация результатов по имени класса, с наследованием

    <?php
    interface Color {
    }

    #[    Attribute]
    class     Fruit {
    }

    function     fruitBasket(
    #[    Fruit]
    #[    Red]
    string $apple
    ) { }

    $reflection = new ReflectionFunction('fruitBasket');
    $parameter = $reflection->getParameter('apple');
    $attributes = $parameter->getAttributes('Color', ReflectionAttribute::IS_INSTANCEOF);
    print_r(array_map(fn($attribute) => $attribute->getName(), $attributes));
    ?>

    Результат выполнения приведённого примера: 

    Array
(
    [0] => Red
)

    Смотрите также

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top