#! 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"Декларирање класи на атрибути
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
Декларирање класи на атрибути
Референца за `language.attributes.classes.php` со подобрена типографија и навигација.
Декларирање класи на атрибути
Се препорачува да се дефинира посебна класа за секој атрибут. Во наједноставниот случај, празна класа со #[Attribute] Се препорачува да се дефинира посебна класа за секој атрибут. Во наједноставниот случај, доволна е празна класа со use
statement.
декларацијата. Атрибутот може да се увезе од глобалниот простор на имиња користејќи
<?php
namespace Example;
use Attribute;
#[Attribute]
class MyAttribute
{
}
Пример #1 Едноставна класа за атрибут #[Attribute]
declaration.
За да се ограничат типовите на декларации на кои може да се примени атрибут, поминете бинарна маска како прв аргумент на
<?php
namespace Example;
use Attribute;
#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_FUNCTION)]
class MyAttribute
{
}Пример #2 Користење на спецификација на цел за ограничување каде може да се користат атрибути MyAttribute Декларирање , осигурувајќи дека валидацијата на аргументите се случува во тој момент.
на друг тип сега ќе фрли исклучок за време на повикот до
Attribute::TARGET_CLASSAttribute::TARGET_FUNCTIONAttribute::TARGET_METHODAttribute::TARGET_PROPERTYAttribute::TARGET_CLASS_CONSTANTAttribute::TARGET_PARAMETERAttribute::TARGET_ALL
Може да се специфицираат следните цели:
#[Attribute] Стандардно, атрибутот може да се користи само еднаш по декларација. За да се дозволи атрибутот да се повторува, специфицирајте го во бинарната маска на
Attribute::IS_REPEATABLE flag.
декларацијата користејќи го
<?php
namespace Example;
use Attribute;
#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_FUNCTION | Attribute::IS_REPEATABLE)]
class MyAttribute
{
}