class ParamConverterManager

core.services.yml in drupal/core/core.services.yml

drupal/core/core.services.yml

paramconverter_manager in drupal/core/core.services.yml

Drupal\Core\ParamConverter\ParamConverterManager

class ParamConverterManager implements RouteEnhancerInterface {

  /**
   * Converters managed by the ParamConverterManager.
   *
   * @var array
   */
  protected $converters;

  /**
   * Adds a converter to the paramconverter service.
   *
   * @see \Drupal\Core\DependencyInjection\Compiler\RegisterParamConvertersPass
   *
   * @param \Drupal\Core\ParamConverter\ParamConverterInterface $converter
   *   The converter to add.
   */
  public function addConverter(ParamConverterInterface $converter) {
    $this->converters[] = $converter;
    return $this;
  }

  /**
   * Implements \Symfony\Cmf\Component\Routing\Enhancer\ŖouteEnhancerIterface.
   *
   * Iterates over all registered converters and allows them to alter the
   * defaults.
   *
   * @param array $defaults
   *   The getRouteDefaults array.
   * @param \Symfony\Component\HttpFoundation\Request $request
   *   The current request.
   *
   * @return array
   *   The modified defaults.
   */
  public function enhance(array $defaults, Request $request) {

    // This array will collect the names of all variables which have been
    // altered by a converter.
    // This serves two purposes:
    // 1. It might prevent converters later in the pipeline to process
    //    a variable again.
    // 2. To check if upcasting was successfull after each converter had
    //    a go. See below.
    $converters = array();
    $route = $defaults[RouteObjectInterface::ROUTE_OBJECT];
    foreach ($this->converters as $converter) {
      $converter
        ->process($defaults, $route, $converters);
    }

    // Check if all upcasting yielded a result.
    // If an upcast value is NULL do a 404.
    foreach ($converters as $variable) {
      if ($defaults[$variable] === NULL) {
        throw new NotFoundHttpException();
      }
    }
    return $defaults;
  }

}