Файл: vendor/symfony/routing/Loader/AttributeClassLoader.php
Строк: 476
<?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 SymfonyComponentRoutingLoader;
use SymfonyComponentConfigLoaderLoaderInterface;
use SymfonyComponentConfigLoaderLoaderResolverInterface;
use SymfonyComponentConfigResourceReflectionClassResource;
use SymfonyComponentRoutingAttributeDeprecatedAlias;
use SymfonyComponentRoutingAttributeRoute as RouteAttribute;
use SymfonyComponentRoutingExceptionInvalidArgumentException;
use SymfonyComponentRoutingExceptionLogicException;
use SymfonyComponentRoutingRoute;
use SymfonyComponentRoutingRouteCollection;
/**
* AttributeClassLoader loads routing information from a PHP class and its methods.
*
* You need to define an implementation for the configureRoute() method. Most of the
* time, this method should define some PHP callable to be called for the route
* (a controller in MVC speak).
*
* The #[Route] attribute can be set on the class (for global parameters),
* and on each method.
*
* The #[Route] attribute main value is the route path. The attribute also
* recognizes several parameters: requirements, options, defaults, schemes,
* methods, host, and name. The name parameter is mandatory.
* Here is an example of how you should be able to use it:
*
* #[Route('/Blog')]
* class Blog
* {
* #[Route('/', name: 'blog_index')]
* public function index()
* {
* }
* #[Route('/{id}', name: 'blog_post', requirements: ["id" => 'd+'])]
* public function show()
* {
* }
* }
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Alexander M. Turek <me@derrabus.de>
* @author Alexandre Daubois <alex.daubois@gmail.com>
*/
abstract class AttributeClassLoader implements LoaderInterface
{
/**
* @deprecated since Symfony 7.2, use "setRouteAttributeClass()" instead.
*/
protected string $routeAnnotationClass = RouteAttribute::class;
private string $routeAttributeClass = RouteAttribute::class;
protected int $defaultRouteIndex = 0;
public function __construct(
protected readonly ?string $env = null,
) {
}
/**
* @deprecated since Symfony 7.2, use "setRouteAttributeClass(string $class)" instead
*
* Sets the annotation class to read route properties from.
*/
public function setRouteAnnotationClass(string $class): void
{
trigger_deprecation('symfony/routing', '7.2', 'The "%s()" method is deprecated, use "%s::setRouteAttributeClass()" instead.', __METHOD__, self::class);
$this->setRouteAttributeClass($class);
}
/**
* Sets the attribute class to read route properties from.
*/
public function setRouteAttributeClass(string $class): void
{
$this->routeAnnotationClass = $class;
$this->routeAttributeClass = $class;
}
/**
* @throws InvalidArgumentException When route can't be parsed
*/
public function load(mixed $class, ?string $type = null): RouteCollection
{
if (!class_exists($class)) {
throw new InvalidArgumentException(sprintf('Class "%s" does not exist.', $class));
}
$class = new ReflectionClass($class);
if ($class->isAbstract()) {
throw new InvalidArgumentException(sprintf('Attributes from class "%s" cannot be read as it is abstract.', $class->getName()));
}
$globals = $this->getGlobals($class);
$collection = new RouteCollection();
$collection->addResource(new ReflectionClassResource($class));
if ($globals['env'] && !in_array($this->env, $globals['env'], true)) {
return $collection;
}
$fqcnAlias = false;
if (!$class->hasMethod('__invoke')) {
foreach ($this->getAttributes($class) as $attr) {
if ($attr->aliases) {
throw new InvalidArgumentException(sprintf('Route aliases cannot be used on non-invokable class "%s".', $class->getName()));
}
}
}
foreach ($class->getMethods() as $method) {
$this->defaultRouteIndex = 0;
$routeNamesBefore = array_keys($collection->all());
foreach ($this->getAttributes($method) as $attr) {
$this->addRoute($collection, $attr, $globals, $class, $method);
if ('__invoke' === $method->name) {
$fqcnAlias = true;
}
}
if (1 === $collection->count() - count($routeNamesBefore)) {
$newRouteName = current(array_diff(array_keys($collection->all()), $routeNamesBefore));
if ($newRouteName !== $aliasName = sprintf('%s::%s', $class->name, $method->name)) {
$collection->addAlias($aliasName, $newRouteName);
}
}
}
if (0 === $collection->count() && $class->hasMethod('__invoke')) {
$globals = $this->resetGlobals();
foreach ($this->getAttributes($class) as $attr) {
$this->addRoute($collection, $attr, $globals, $class, $class->getMethod('__invoke'));
$fqcnAlias = true;
}
}
if ($fqcnAlias && 1 === $collection->count()) {
$invokeRouteName = key($collection->all());
if ($invokeRouteName !== $class->name) {
$collection->addAlias($class->name, $invokeRouteName);
}
if ($invokeRouteName !== $aliasName = sprintf('%s::__invoke', $class->name)) {
$collection->addAlias($aliasName, $invokeRouteName);
}
}
return $collection;
}
/**
* @param RouteAttribute $attr or an object that exposes a similar interface
*/
protected function addRoute(RouteCollection $collection, object $attr, array $globals, ReflectionClass $class, ReflectionMethod $method): void
{
if ($attr->envs && !in_array($this->env, $attr->envs, true)) {
return;
}
$name = $attr->name ?? $this->getDefaultRouteName($class, $method);
$name = $globals['name'].$name;
$requirements = $attr->requirements;
foreach ($requirements as $placeholder => $requirement) {
if (is_int($placeholder)) {
throw new InvalidArgumentException(sprintf('A placeholder name must be a string (%d given). Did you forget to specify the placeholder key for the requirement "%s" of route "%s" in "%s::%s()"?', $placeholder, $requirement, $name, $class->getName(), $method->getName()));
}
}
$defaults = array_replace($globals['defaults'], $attr->defaults);
$requirements = array_replace($globals['requirements'], $requirements);
$options = array_replace($globals['options'], $attr->options);
$schemes = array_unique(array_merge($globals['schemes'], $attr->schemes));
$methods = array_unique(array_merge($globals['methods'], $attr->methods));
$host = $attr->host ?? $globals['host'];
$condition = $attr->condition ?? $globals['condition'];
$priority = $attr->priority ?? $globals['priority'];
$path = $attr->path;
$prefix = $globals['localized_paths'] ?: $globals['path'];
$paths = [];
if (is_array($path)) {
if (!is_array($prefix)) {
foreach ($path as $locale => $localePath) {
$paths[$locale] = $prefix.$localePath;
}
} elseif ($missing = array_diff_key($prefix, $path)) {
throw new LogicException(sprintf('Route to "%s" is missing paths for locale(s) "%s".', $class->name.'::'.$method->name, implode('", "', array_keys($missing))));
} else {
foreach ($path as $locale => $localePath) {
if (!isset($prefix[$locale])) {
throw new LogicException(sprintf('Route to "%s" with locale "%s" is missing a corresponding prefix in class "%s".', $method->name, $locale, $class->name));
}
$paths[$locale] = $prefix[$locale].$localePath;
}
}
} elseif (is_array($prefix)) {
foreach ($prefix as $locale => $localePrefix) {
$paths[$locale] = $localePrefix.$path;
}
} else {
$paths[] = $prefix.$path;
}
foreach ($method->getParameters() as $param) {
if (isset($defaults[$param->name]) || !$param->isDefaultValueAvailable()) {
continue;
}
foreach ($paths as $locale => $path) {
if (preg_match(sprintf('/{(?|([^}:<]++):%s(?:.[^}<]++)?|(%1$s))(?:<.*?>)?}/', preg_quote($param->name)), $path, $matches)) {
if (is_scalar($defaultValue = $param->getDefaultValue()) || null === $defaultValue) {
$defaults[$matches[1]] = $defaultValue;
} elseif ($defaultValue instanceof BackedEnum) {
$defaults[$matches[1]] = $defaultValue->value;
}
break;
}
}
}
foreach ($paths as $locale => $path) {
$route = $this->createRoute($path, $defaults, $requirements, $options, $host, $schemes, $methods, $condition);
$this->configureRoute($route, $class, $method, $attr);
if (0 !== $locale) {
$route->setDefault('_locale', $locale);
$route->setRequirement('_locale', preg_quote($locale));
$route->setDefault('_canonical_route', $name);
$collection->add($name.'.'.$locale, $route, $priority);
} else {
$collection->add($name, $route, $priority);
}
}
foreach ($attr->aliases as $aliasAttribute) {
$aliasName = $aliasAttribute instanceof DeprecatedAlias ? $aliasAttribute->aliasName : $aliasAttribute;
foreach (array_keys($paths) as $locale) {
$suffix = 0 !== $locale ? '.'.$locale : '';
$alias = $collection->addAlias($aliasName.$suffix, $name.$suffix);
if ($aliasAttribute instanceof DeprecatedAlias) {
$alias->setDeprecated(
$aliasAttribute->package,
$aliasAttribute->version,
$aliasAttribute->message
);
}
}
}
}
public function supports(mixed $resource, ?string $type = null): bool
{
return is_string($resource) && preg_match('/^(?:\\?[a-zA-Z_x7f-xff][a-zA-Z0-9_x7f-xff]*)+$/', $resource) && (!$type || 'attribute' === $type);
}
public function setResolver(LoaderResolverInterface $resolver): void
{
}
public function getResolver(): LoaderResolverInterface
{
throw new LogicException(sprintf('The "%s()" method must not be called.', __METHOD__));
}
/**
* Gets the default route name for a class method.
*
* @return string
*/
protected function getDefaultRouteName(ReflectionClass $class, ReflectionMethod $method)
{
$name = str_replace('\', '_', $class->name).'_'.$method->name;
$name = function_exists('mb_strtolower') && preg_match('//u', $name) ? mb_strtolower($name, 'UTF-8') : strtolower($name);
if ($this->defaultRouteIndex > 0) {
$name .= '_'.$this->defaultRouteIndex;
}
++$this->defaultRouteIndex;
return $name;
}
/**
* @return array<string, mixed>
*/
protected function getGlobals(ReflectionClass $class): array
{
$globals = $this->resetGlobals();
// to be replaced in Symfony 8.0 by $this->routeAttributeClass
if ($attribute = $class->getAttributes($this->routeAnnotationClass, ReflectionAttribute::IS_INSTANCEOF)[0] ?? null) {
$attr = $attribute->newInstance();
if (null !== $attr->name) {
$globals['name'] = $attr->name;
}
if (is_string($attr->path)) {
$globals['path'] = $attr->path;
$globals['localized_paths'] = [];
} else {
$globals['localized_paths'] = $attr->path ?? [];
}
if (null !== $attr->requirements) {
$globals['requirements'] = $attr->requirements;
}
if (null !== $attr->options) {
$globals['options'] = $attr->options;
}
if (null !== $attr->defaults) {
$globals['defaults'] = $attr->defaults;
}
if (null !== $attr->schemes) {
$globals['schemes'] = $attr->schemes;
}
if (null !== $attr->methods) {
$globals['methods'] = $attr->methods;
}
if (null !== $attr->host) {
$globals['host'] = $attr->host;
}
if (null !== $attr->condition) {
$globals['condition'] = $attr->condition;
}
$globals['priority'] = $attr->priority ?? 0;
$globals['env'] = $attr->envs;
foreach ($globals['requirements'] as $placeholder => $requirement) {
if (is_int($placeholder)) {
throw new InvalidArgumentException(sprintf('A placeholder name must be a string (%d given). Did you forget to specify the placeholder key for the requirement "%s" in "%s"?', $placeholder, $requirement, $class->getName()));
}
}
}
return $globals;
}
private function resetGlobals(): array
{
return [
'path' => null,
'localized_paths' => [],
'requirements' => [],
'options' => [],
'defaults' => [],
'schemes' => [],
'methods' => [],
'host' => '',
'condition' => '',
'name' => '',
'priority' => 0,
'env' => null,
];
}
protected function createRoute(string $path, array $defaults, array $requirements, array $options, ?string $host, array $schemes, array $methods, ?string $condition): Route
{
return new Route($path, $defaults, $requirements, $options, $host, $schemes, $methods, $condition);
}
/**
* @param RouteAttribute $attr or an object that exposes a similar interface
*
* @return void
*/
abstract protected function configureRoute(Route $route, ReflectionClass $class, ReflectionMethod $method, object $attr);
/**
* @return iterable<int, RouteAttribute>
*/
private function getAttributes(ReflectionClass|ReflectionMethod $reflection): iterable
{
// to be replaced in Symfony 8.0 by $this->routeAttributeClass
foreach ($reflection->getAttributes($this->routeAnnotationClass, ReflectionAttribute::IS_INSTANCEOF) as $attribute) {
yield $attribute->newInstance();
}
}
}