67 lines
2.3 KiB
PHP
67 lines
2.3 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the Symfony package.
|
|
*
|
|
* (c) Fabien Potencier <fabien@symfony.com>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Symfony\Component\DependencyInjection\Attribute;
|
|
|
|
use Symfony\Component\DependencyInjection\Exception\InvalidArgumentException;
|
|
use Symfony\Component\DependencyInjection\Exception\LogicException;
|
|
|
|
/**
|
|
* An attribute to tell how a dependency is used and hint named autowiring aliases.
|
|
*
|
|
* @author Nicolas Grekas <p@tchwork.com>
|
|
*/
|
|
#[\Attribute(\Attribute::TARGET_PARAMETER)]
|
|
final class Target
|
|
{
|
|
/**
|
|
* @param string|null $name The name of the target autowiring alias
|
|
*/
|
|
public function __construct(public ?string $name = null)
|
|
{
|
|
}
|
|
|
|
public function getParsedName(): string
|
|
{
|
|
if (null === $this->name) {
|
|
throw new LogicException(\sprintf('Cannot parse the name of a #[Target] attribute that has not been resolved. Did you forget to call "%s::parseName()"?', __CLASS__));
|
|
}
|
|
|
|
return lcfirst(str_replace(' ', '', ucwords(preg_replace('/[^a-zA-Z0-9\x7f-\xff]++/', ' ', $this->name))));
|
|
}
|
|
|
|
public static function parseName(\ReflectionParameter $parameter, ?self &$attribute = null, ?string &$parsedName = null): string
|
|
{
|
|
$attribute = null;
|
|
if (!$target = $parameter->getAttributes(self::class)[0] ?? null) {
|
|
$parsedName = (new self($parameter->name))->getParsedName();
|
|
|
|
return $parameter->name;
|
|
}
|
|
|
|
$attribute = $target->newInstance();
|
|
$name = $attribute->name ??= $parameter->name;
|
|
$parsedName = $attribute->getParsedName();
|
|
|
|
if (!preg_match('/^[a-zA-Z_\x7f-\xff]/', $parsedName)) {
|
|
if (($function = $parameter->getDeclaringFunction()) instanceof \ReflectionMethod) {
|
|
$function = $function->class.'::'.$function->name;
|
|
} else {
|
|
$function = $function->name;
|
|
}
|
|
|
|
throw new InvalidArgumentException(\sprintf('Invalid #[Target] name "%s" on parameter "$%s" of "%s()": the first character must be a letter.', $name, $parameter->name, $function));
|
|
}
|
|
|
|
return preg_match('/^[a-zA-Z0-9_\x7f-\xff]++$/', $name) ? $name : $parsedName;
|
|
}
|
|
}
|