update page now
Laravel Live Japan

    Объявление классов атрибутов

    Для каждого атрибута рекомендуют определять отдельный класс. В самом простом случае достаточно создать пустой класс и объявить для класса атрибут #[Attribute], который импортируют из глобального пространства имён оператором use.

    Пример #1 Пример простого класса с атрибутом

    <?php

    namespace Example;

    use     Attribute;

    #[    Attribute]
    class     MyAttribute {}

    ?>

    Типы объявлений для нацеливания атрибута ограничивают путём передачи битовой маски в первом аргументе объявления #[Attribute].

    Пример #2 Спецификация ограничения целей, доступных для присваивания атрибутов

    <?php

    namespace Example;

    use     Attribute;

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

    ?>

    Вызов метода ReflectionAttribute::newInstance() теперь выбросит исключение при объявлении атрибута MyAttribute для другого типа, кроме метода или функции.

    Атрибутам доступны следующие цели:

    По умолчанию атрибут разрешается назначить классу, свойству или другому объекту рефлексии только один раз. Назначить одинаковые атрибуты одному объекту рефлексии получится, только если объявить атрибут #[Attribute] с флагом Attribute::IS_REPEATABLE в битовой маске.

    Пример #3 Пример с константой IS_REPEATABL, которая разрешит назначать атрибут многократно

    <?php

    namespace Example;

    use     Attribute;

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

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 1 note

    up
    15
    esdras-schonevald
    3 years ago
    #! Require PHP >= 8.0

#! This is a Sample

<?php

declare(strict_types = 1);

#[Attribute]
class Foo
{
    function __construct(){
        echo "Running " . __METHOD__ . PHP_EOL;
    }
}

#[Attribute(Attribute::TARGET_CLASS|Attribute::IS_REPEATABLE)]
class Bar {
    function __construct(?string ...$args){
        echo "Running " . __METHOD__ ,
            " args: " . implode(", ", $args) . PHP_EOL;
    }
}

#[Attribute(Attribute::TARGET_ALL)]
class Baz {
    function __construct(
        private string $parameter
    ){
        echo "Running " . __METHOD__ ,
            " arg: " . $this->parameter . PHP_EOL;
    }
}

#[Foo]                                      // [0]
#[Bar]                                      // [1]
#[Bar("Banana")]                            // [2]
#[Bar("Banana", "Apple", "Lemon", "Grape")] // [3]
#[Baz("The Only One")]                      // [4]
class Qux
{
}

// Getting class attribute with ReflectionClass
$ref    =   new ReflectionClass(Qux::class);
$attrs  =   $ref->getAttributes(); // Array of attributes

$attrs[0]->newInstance(); // "Running Foo::__construct"
$attrs[1]->newInstance(); // "Running Bar::__construct args: "
$attrs[2]->newInstance(); // "Running Bar::__construct args: Banana"
$attrs[3]->newInstance(); // "Running Bar::__construct args: Banana, Apple, Lemon, Grape"
$attrs[4]->newInstance(); // "Running Baz::__construct arg: The Only One"
    ＋Добавить
    To Top