ControllerResolverInterface.php in Zircon Profile 8

Namespace

Symfony\Component\HttpKernel\Controller

File

vendor/symfony/http-kernel/Controller/ControllerResolverInterface.php

<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <[e-mail]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace Symfony\Component\HttpKernel\Controller;

use Symfony\Component\HttpFoundation\Request;

/**
 * A ControllerResolverInterface implementation knows how to determine the
 * controller to execute based on a Request object.
 *
 * It can also determine the arguments to pass to the Controller.
 *
 * A Controller can be any valid PHP callable.
 *
 * @author Fabien Potencier <[e-mail]>
 */
interface ControllerResolverInterface {

  /**
   * Returns the Controller instance associated with a Request.
   *
   * As several resolvers can exist for a single application, a resolver must
   * return false when it is not able to determine the controller.
   *
   * The resolver must only throw an exception when it should be able to load
   * controller but cannot because of some errors made by the developer.
   *
   * @param Request $request A Request instance
   *
   * @return callable|false A PHP callable representing the Controller,
   *                        or false if this resolver is not able to determine the controller
   *
   * @throws \LogicException If the controller can't be found
   */
  public function getController(Request $request);

  /**
   * Returns the arguments to pass to the controller.
   *
   * @param Request  $request    A Request instance
   * @param callable $controller A PHP callable
   *
   * @return array An array of arguments to pass to the controller
   *
   * @throws \RuntimeException When value for argument given is not provided
   */
  public function getArguments(Request $request, $controller);

}

Interfaces

Name	Description
ControllerResolverInterface	A ControllerResolverInterface implementation knows how to determine the controller to execute based on a Request object.