view core/lib/Drupal/Core/Controller/ControllerResolverInterface.php @ 13:5fb285c0d0e3

Update Drupal core to 8.4.7 via Composer. Security update; I *think* we've
been lucky to get away with this so far, as we don't support self-registration
which seems to be used by the so-called "drupalgeddon 2" attack that 8.4.5
was vulnerable to.

<?php

namespace Drupal\Core\Controller;

use Symfony\Component\HttpKernel\Controller\ControllerResolverInterface as BaseControllerResolverInterface;

/**
 * Extends the ControllerResolverInterface from symfony.
 */
interface ControllerResolverInterface extends BaseControllerResolverInterface {

  /**
   * Returns the Controller instance with a given controller route definition.
   *
   * As several resolvers can exist for a single application, a resolver must
   * return false when it is not able to determine the controller.
   *
   * @param mixed $controller
   *   The controller attribute like in $request->attributes->get('_controller')
   *
   * @return mixed|bool
   *   A PHP callable representing the Controller, or false if this resolver is
   *   not able to determine the controller
   *
   * @throws \InvalidArgumentException|\LogicException
   *   Thrown if the controller can't be found.
   *
   * @see \Symfony\Component\HttpKernel\Controller\ControllerResolverInterface::getController()
   */
  public function getControllerFromDefinition($controller);

}