ReflectionParameter::getAttributes
Gets Attributes
Description
public array ReflectionParameter::getAttributes(stringnull $name
= null
, int $flags
= 0)
Parameters
-
name
-
Filter the results to include only ReflectionAttribute
instances for attributes matching this class name.
-
flags
-
Flags for determining how to filter the results, if name
is provided.
Default is 0
which will only return results for attributes that
are of the class name
.
The only other option available, is to use ReflectionAttribute::IS_INSTANCEOF
,
which will instead use instanceof
for filtering.
Return Values
Array of attributes, as a ReflectionAttribute object.
Examples
Example #1 Basic usage
<?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));
?>
The above example will output:
Array
(
[0] => Fruit
[1] => Red
)
Example #2 Filtering results by class name
<?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));
?>
The above example will output:
Example #3 Filtering results by class name, with inheritance
<?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));
?>
The above example will output:
See Also
- ReflectionClass::getAttributes
- ReflectionClassConstant::getAttributes
- ReflectionFunctionAbstract::getAttributes
- ReflectionProperty::getAttributes