class ControllerResolver
Same name in other branches
- 9 core/lib/Drupal/Core/Controller/ControllerResolver.php \Drupal\Core\Controller\ControllerResolver
- 10 core/lib/Drupal/Core/Controller/ControllerResolver.php \Drupal\Core\Controller\ControllerResolver
- 11.x core/lib/Drupal/Core/Controller/ControllerResolver.php \Drupal\Core\Controller\ControllerResolver
ControllerResolver to enhance controllers beyond Symfony's basic handling.
It adds two behaviors:
- When creating a new object-based controller that implements ContainerAwareInterface, inject the container into it. While not always necessary, that allows a controller to vary the services it needs at runtime.
- By default, a controller name follows the class::method notation. This class adds the possibility to use a service from the container as a controller by using a service:method notation (Symfony uses the same convention).
Hierarchy
- class \Drupal\Core\Controller\ControllerResolver extends \Symfony\Component\HttpKernel\Controller\ControllerResolver implements \Drupal\Core\Controller\ControllerResolverInterface
Expanded class hierarchy of ControllerResolver
5 files declare their use of ControllerResolver
- ControllerResolverTest.php in core/
tests/ Drupal/ Tests/ Core/ Controller/ ControllerResolverTest.php - Contains \Drupal\Tests\Core\Controller\ControllerResolverTest.
- CustomAccessCheckTest.php in core/
tests/ Drupal/ Tests/ Core/ Access/ CustomAccessCheckTest.php - Contains \Drupal\Tests\Core\Access\CustomAccessCheckTest.
- FormControllerTest.php in core/
tests/ Drupal/ Tests/ Core/ Controller/ FormControllerTest.php - LocalActionManagerTest.php in core/
tests/ Drupal/ Tests/ Core/ Menu/ LocalActionManagerTest.php - Contains \Drupal\Tests\Core\Menu\LocalActionManagerTest.
- LocalTaskManagerTest.php in core/
tests/ Drupal/ Tests/ Core/ Menu/ LocalTaskManagerTest.php
2 string references to 'ControllerResolver'
- ContextualLinkManagerTest::setUp in core/
tests/ Drupal/ Tests/ Core/ Menu/ ContextualLinkManagerTest.php - core.services.yml in core/
core.services.yml - core/core.services.yml
1 service uses ControllerResolver
File
-
core/
lib/ Drupal/ Core/ Controller/ ControllerResolver.php, line 28
Namespace
Drupal\Core\ControllerView source
class ControllerResolver extends BaseControllerResolver implements ControllerResolverInterface {
/**
* The class resolver.
*
* @var \Drupal\Core\DependencyInjection\ClassResolverInterface
*/
protected $classResolver;
/**
* The PSR-7 converter.
*
* @var \Symfony\Bridge\PsrHttpMessage\HttpMessageFactoryInterface
*/
protected $httpMessageFactory;
/**
* Constructs a new ControllerResolver.
*
* @param \Symfony\Bridge\PsrHttpMessage\HttpMessageFactoryInterface $http_message_factory
* The PSR-7 converter.
* @param \Drupal\Core\DependencyInjection\ClassResolverInterface $class_resolver
* The class resolver.
*/
public function __construct(HttpMessageFactoryInterface $http_message_factory, ClassResolverInterface $class_resolver) {
$this->httpMessageFactory = $http_message_factory;
$this->classResolver = $class_resolver;
}
/**
* {@inheritdoc}
*/
public function getControllerFromDefinition($controller, $path = '') {
if (is_array($controller) || is_object($controller) && method_exists($controller, '__invoke')) {
return $controller;
}
if (strpos($controller, ':') === FALSE) {
if (function_exists($controller)) {
return $controller;
}
return $this->classResolver
->getInstanceFromDefinition($controller);
}
$callable = $this->createController($controller);
if (!is_callable($callable)) {
throw new \InvalidArgumentException(sprintf('The controller for URI "%s" is not callable.', $path));
}
return $callable;
}
/**
* {@inheritdoc}
*/
public function getController(Request $request) {
if (!($controller = $request->attributes
->get('_controller'))) {
return FALSE;
}
return $this->getControllerFromDefinition($controller, $request->getPathInfo());
}
/**
* Returns a callable for the given controller.
*
* @param string $controller
* A Controller string.
*
* @return mixed
* A PHP callable.
*
* @throws \LogicException
* If the controller cannot be parsed.
*
* @throws \InvalidArgumentException
* If the controller class does not exist.
*/
protected function createController($controller) {
// Controller in the service:method notation.
$count = substr_count($controller, ':');
if ($count == 1) {
list($class_or_service, $method) = explode(':', $controller, 2);
}
elseif (strpos($controller, '::') !== FALSE) {
list($class_or_service, $method) = explode('::', $controller, 2);
}
else {
throw new \LogicException(sprintf('Unable to parse the controller name "%s".', $controller));
}
$controller = $this->classResolver
->getInstanceFromDefinition($class_or_service);
return [
$controller,
$method,
];
}
/**
* {@inheritdoc}
*/
protected function doGetArguments(Request $request, $controller, array $parameters) {
// Note this duplicates the deprecation message of
// Symfony\Component\HttpKernel\Controller\ControllerResolver::getArguments()
// to ensure it is removed in Drupal 9.
@trigger_error(sprintf('%s is deprecated as of 8.6.0 and will be removed in 9.0. Inject the "http_kernel.controller.argument_resolver" service instead.', __METHOD__, ArgumentResolverInterface::class), E_USER_DEPRECATED);
$attributes = $request->attributes
->all();
$arguments = [];
foreach ($parameters as $param) {
if (array_key_exists($param->name, $attributes)) {
$arguments[] = $attributes[$param->name];
}
elseif ($param->getClass() && $param->getClass()
->isInstance($request)) {
$arguments[] = $request;
}
elseif ($param->getClass() && $param->getClass()->name === ServerRequestInterface::class) {
$arguments[] = $this->httpMessageFactory
->createRequest($request);
}
elseif ($param->getClass() && ($param->getClass()->name == RouteMatchInterface::class || is_subclass_of($param->getClass()->name, RouteMatchInterface::class))) {
$arguments[] = RouteMatch::createFromRequest($request);
}
elseif ($param->isDefaultValueAvailable()) {
$arguments[] = $param->getDefaultValue();
}
else {
if (is_array($controller)) {
$repr = sprintf('%s::%s()', get_class($controller[0]), $controller[1]);
}
elseif (is_object($controller)) {
$repr = get_class($controller);
}
else {
$repr = $controller;
}
throw new \RuntimeException(sprintf('Controller "%s" requires that you provide a value for the "$%s" argument (because there is no default value or because there is a non optional argument after this one).', $repr, $param->name));
}
}
return $arguments;
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|
ControllerResolver::$classResolver | protected | property | The class resolver. | |
ControllerResolver::$httpMessageFactory | protected | property | The PSR-7 converter. | |
ControllerResolver::createController | protected | function | Returns a callable for the given controller. | |
ControllerResolver::doGetArguments | protected | function | ||
ControllerResolver::getController | public | function | ||
ControllerResolver::getControllerFromDefinition | public | function | Returns the Controller instance with a given controller route definition. | Overrides ControllerResolverInterface::getControllerFromDefinition |
ControllerResolver::__construct | public | function | Constructs a new ControllerResolver. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.