vendor/symfony/framework-bundle/HttpCache/HttpCache.php line 62

Open in your IDE?
  1. <?php
  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.  */
  12. namespace Symfony\Bundle\FrameworkBundle\HttpCache;
  14. use Symfony\Component\HttpFoundation\Request;
  15. use Symfony\Component\HttpFoundation\Response;
  16. use Symfony\Component\HttpKernel\HttpCache\Esi;
  17. use Symfony\Component\HttpKernel\HttpCache\HttpCache as BaseHttpCache;
  18. use Symfony\Component\HttpKernel\HttpCache\Store;
  19. use Symfony\Component\HttpKernel\KernelInterface;
  21. /**
  22.  * Manages HTTP cache objects in a Container.
  23.  *
  24.  * @author Fabien Potencier <fabien@symfony.com>
  25.  */
  26. class HttpCache extends BaseHttpCache
  27. {
  28.     protected $cacheDir;
  29.     protected $kernel;
  31.     /**
  32.      * @param string $cacheDir The cache directory (default used if null)
  33.      */
  34.     public function __construct(KernelInterface $kernel, string $cacheDir = null)
  35.     {
  36.         $this->kernel = $kernel;
  37.         $this->cacheDir = $cacheDir;
  39.         $isDebug = $kernel->isDebug();
  40.         $options = ['debug' => $isDebug];
  42.         if ($isDebug) {
  43.             $options['stale_if_error'] = 0;
  44.         }
  46.         parent::__construct($kernel, $this->createStore(), $this->createSurrogate(), array_merge($options, $this->getOptions()));
  47.     }
  49.     /**
  50.      * Forwards the Request to the backend and returns the Response.
  51.      *
  52.      * @param bool     $raw   Whether to catch exceptions or not
  53.      * @param Response $entry A Response instance (the stale entry if present, null otherwise)
  54.      *
  55.      * @return Response A Response instance
  56.      */
  57.     protected function forward(Request $request, $raw = false, Response $entry = null)
  58.     {
  59.         $this->getKernel()->boot();
  60.         $this->getKernel()->getContainer()->set('cache', $this);
  62.         return parent::forward($request, $raw, $entry);
  63.     }
  65.     /**
  66.      * Returns an array of options to customize the Cache configuration.
  67.      *
  68.      * @return array An array of options
  69.      */
  70.     protected function getOptions()
  71.     {
  72.         return [];
  73.     }
  75.     protected function createSurrogate()
  76.     {
  77.         return new Esi();
  78.     }
  80.     protected function createStore()
  81.     {
  82.         return new Store($this->cacheDir ?: $this->kernel->getCacheDir().'/http_cache');
  83.     }
  84. }