102 lines
2.6 KiB
PHP
102 lines
2.6 KiB
PHP
<?php
|
|
|
|
namespace Doctrine\Common\Annotations\Annotation;
|
|
|
|
use InvalidArgumentException;
|
|
|
|
use function array_keys;
|
|
use function get_class;
|
|
use function gettype;
|
|
use function implode;
|
|
use function is_array;
|
|
use function is_object;
|
|
use function is_string;
|
|
use function sprintf;
|
|
|
|
/**
|
|
* Annotation that can be used to signal to the parser
|
|
* to check the annotation target during the parsing process.
|
|
*
|
|
* @Annotation
|
|
*/
|
|
final class Target
|
|
{
|
|
public const TARGET_CLASS = 1;
|
|
public const TARGET_METHOD = 2;
|
|
public const TARGET_PROPERTY = 4;
|
|
public const TARGET_ANNOTATION = 8;
|
|
public const TARGET_FUNCTION = 16;
|
|
public const TARGET_ALL = 31;
|
|
|
|
/** @var array<string, int> */
|
|
private static $map = [
|
|
'ALL' => self::TARGET_ALL,
|
|
'CLASS' => self::TARGET_CLASS,
|
|
'METHOD' => self::TARGET_METHOD,
|
|
'PROPERTY' => self::TARGET_PROPERTY,
|
|
'FUNCTION' => self::TARGET_FUNCTION,
|
|
'ANNOTATION' => self::TARGET_ANNOTATION,
|
|
];
|
|
|
|
/** @phpstan-var list<string> */
|
|
public $value;
|
|
|
|
/**
|
|
* Targets as bitmask.
|
|
*
|
|
* @var int
|
|
*/
|
|
public $targets;
|
|
|
|
/**
|
|
* Literal target declaration.
|
|
*
|
|
* @var string
|
|
*/
|
|
public $literal;
|
|
|
|
/**
|
|
* @throws InvalidArgumentException
|
|
*
|
|
* @phpstan-param array{value?: string|list<string>} $values
|
|
*/
|
|
public function __construct(array $values)
|
|
{
|
|
if (! isset($values['value'])) {
|
|
$values['value'] = null;
|
|
}
|
|
|
|
if (is_string($values['value'])) {
|
|
$values['value'] = [$values['value']];
|
|
}
|
|
|
|
if (! is_array($values['value'])) {
|
|
throw new InvalidArgumentException(
|
|
sprintf(
|
|
'@Target expects either a string value, or an array of strings, "%s" given.',
|
|
is_object($values['value']) ? get_class($values['value']) : gettype($values['value'])
|
|
)
|
|
);
|
|
}
|
|
|
|
$bitmask = 0;
|
|
foreach ($values['value'] as $literal) {
|
|
if (! isset(self::$map[$literal])) {
|
|
throw new InvalidArgumentException(
|
|
sprintf(
|
|
'Invalid Target "%s". Available targets: [%s]',
|
|
$literal,
|
|
implode(', ', array_keys(self::$map))
|
|
)
|
|
);
|
|
}
|
|
|
|
$bitmask |= self::$map[$literal];
|
|
}
|
|
|
|
$this->targets = $bitmask;
|
|
$this->value = $values['value'];
|
|
$this->literal = implode(', ', $this->value);
|
|
}
|
|
}
|