4 * This file is part of the Symfony package.
6 * (c) Fabien Potencier <fabien@symfony.com>
8 * For the full copyright and license information, please view the LICENSE
9 * file that was distributed with this source code.
12 namespace Symfony\Component\HttpKernel\Controller;
14 use Symfony\Component\HttpFoundation\Request;
17 * A ControllerResolverInterface implementation knows how to determine the
18 * controller to execute based on a Request object.
20 * It can also determine the arguments to pass to the Controller.
22 * A Controller can be any valid PHP callable.
24 * @author Fabien Potencier <fabien@symfony.com>
26 interface ControllerResolverInterface
29 * Returns the Controller instance associated with a Request.
31 * As several resolvers can exist for a single application, a resolver must
32 * return false when it is not able to determine the controller.
34 * The resolver must only throw an exception when it should be able to load
35 * controller but cannot because of some errors made by the developer.
37 * @param Request $request A Request instance
39 * @return callable|false A PHP callable representing the Controller,
40 * or false if this resolver is not able to determine the controller
42 * @throws \LogicException If the controller can't be found
44 public function getController(Request $request);
47 * Returns the arguments to pass to the controller.
49 * @param Request $request A Request instance
50 * @param callable $controller A PHP callable
52 * @return array An array of arguments to pass to the controller
54 * @throws \RuntimeException When value for argument given is not provided
56 public function getArguments(Request $request, $controller);