class ParamConversionEnhancer
Same name in other branches
- 8.9.x core/lib/Drupal/Core/Routing/Enhancer/ParamConversionEnhancer.php \Drupal\Core\Routing\Enhancer\ParamConversionEnhancer
- 10 core/lib/Drupal/Core/Routing/Enhancer/ParamConversionEnhancer.php \Drupal\Core\Routing\Enhancer\ParamConversionEnhancer
- 11.x core/lib/Drupal/Core/Routing/Enhancer/ParamConversionEnhancer.php \Drupal\Core\Routing\Enhancer\ParamConversionEnhancer
Provides a route enhancer that handles parameter conversion.
Hierarchy
- class \Drupal\Core\Routing\Enhancer\ParamConversionEnhancer implements \Drupal\Core\Routing\EnhancerInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface
Expanded class hierarchy of ParamConversionEnhancer
1 file declares its use of ParamConversionEnhancer
- ParamConversionEnhancerTest.php in core/
tests/ Drupal/ Tests/ Core/ Enhancer/ ParamConversionEnhancerTest.php
1 string reference to 'ParamConversionEnhancer'
- core.services.yml in core/
core.services.yml - core/core.services.yml
1 service uses ParamConversionEnhancer
File
-
core/
lib/ Drupal/ Core/ Routing/ Enhancer/ ParamConversionEnhancer.php, line 19
Namespace
Drupal\Core\Routing\EnhancerView source
class ParamConversionEnhancer implements EnhancerInterface, EventSubscriberInterface {
/**
* The parameter conversion manager.
*
* @var \Drupal\Core\ParamConverter\ParamConverterManagerInterface
*/
protected $paramConverterManager;
/**
* Constructs a new ParamConversionEnhancer.
*
* @param \Drupal\Core\ParamConverter\ParamConverterManagerInterface $param_converter_manager
* The parameter conversion manager.
*/
public function __construct(ParamConverterManagerInterface $param_converter_manager) {
$this->paramConverterManager = $param_converter_manager;
}
/**
* {@inheritdoc}
*/
public function enhance(array $defaults, Request $request) {
// Just run the parameter conversion once per request.
if (!isset($defaults['_raw_variables'])) {
$defaults['_raw_variables'] = $this->copyRawVariables($defaults);
$defaults = $this->paramConverterManager
->convert($defaults);
}
return $defaults;
}
/**
* Store a backup of the raw values that corresponding to the route pattern.
*
* @param array $defaults
* The route defaults array.
*
* @return \Symfony\Component\HttpFoundation\ParameterBag
*/
protected function copyRawVariables(array $defaults) {
/** @var \Symfony\Component\Routing\Route $route */
$route = $defaults[RouteObjectInterface::ROUTE_OBJECT];
$variables = array_flip($route->compile()
->getVariables());
// Foreach will copy the values from the array it iterates. Even if they
// are references, use it to break them. This avoids any scenarios where raw
// variables also get replaced with converted values.
$raw_variables = [];
foreach (array_intersect_key($defaults, $variables) as $key => $value) {
$raw_variables[$key] = $value;
}
// Route defaults that do not start with a leading "_" are also
// parameters, even if they are not included in path or host patterns.
foreach ($route->getDefaults() as $name => $value) {
if (!isset($raw_variables[$name]) && substr($name, 0, 1) !== '_') {
$raw_variables[$name] = $value;
}
}
return new ParameterBag($raw_variables);
}
/**
* Catches failed parameter conversions and throw a 404 instead.
*
* @param \Symfony\Component\HttpKernel\Event\ExceptionEvent $event
* The event.
*/
public function onException(ExceptionEvent $event) {
$exception = $event->getThrowable();
if ($exception instanceof ParamNotConvertedException) {
$event->setThrowable(new NotFoundHttpException($exception->getMessage(), $exception));
}
}
/**
* {@inheritdoc}
*/
public static function getSubscribedEvents() {
$events[KernelEvents::EXCEPTION][] = [
'onException',
75,
];
return $events;
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|
ParamConversionEnhancer::$paramConverterManager | protected | property | The parameter conversion manager. | |
ParamConversionEnhancer::copyRawVariables | protected | function | Store a backup of the raw values that corresponding to the route pattern. | |
ParamConversionEnhancer::enhance | public | function | Updates the defaults for a route definition based on the request. | Overrides EnhancerInterface::enhance |
ParamConversionEnhancer::getSubscribedEvents | public static | function | ||
ParamConversionEnhancer::onException | public | function | Catches failed parameter conversions and throw a 404 instead. | |
ParamConversionEnhancer::__construct | public | function | Constructs a new ParamConversionEnhancer. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.