www.aleph1.co.uk Git - yaffs-website/blob - vendor/symfony/http-kernel/HttpKernelInterface.php

   1 <?php
   2
   3 /*
   4  * This file is part of the Symfony package.
   5  *
   6  * (c) Fabien Potencier <fabien@symfony.com>
   7  *
   8  * For the full copyright and license information, please view the LICENSE
   9  * file that was distributed with this source code.
  10  */
  11
  12 namespace Symfony\Component\HttpKernel;
  13
  14 use Symfony\Component\HttpFoundation\Request;
  15 use Symfony\Component\HttpFoundation\Response;
  16
  17 /**
  18  * HttpKernelInterface handles a Request to convert it to a Response.
  19  *
  20  * @author Fabien Potencier <fabien@symfony.com>
  21  */
  22 interface HttpKernelInterface
  23 {
  24     const MASTER_REQUEST = 1;
  25     const SUB_REQUEST = 2;
  26
  27     /**
  28      * Handles a Request to convert it to a Response.
  29      *
  30      * When $catch is true, the implementation must catch all exceptions
  31      * and do its best to convert them to a Response instance.
  32      *
  33      * @param Request $request A Request instance
  34      * @param int     $type    The type of the request
  35      *                         (one of HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST)
  36      * @param bool    $catch   Whether to catch exceptions or not
  37      *
  38      * @return Response A Response instance
  39      *
  40      * @throws \Exception When an Exception occurs during processing
  41      */
  42     public function handle(Request $request, $type = self::MASTER_REQUEST, $catch = true);
  43 }