vendor/api-platform/core/src/HttpCache/EventListener/AddHeadersListener.php line 50

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the API Platform project.
  5.  *
  6.  * (c) Kévin Dunglas <dunglas@gmail.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. declare(strict_types=1);
  14. namespace ApiPlatform\Core\HttpCache\EventListener;
  16. use ApiPlatform\Core\Metadata\Resource\Factory\ResourceMetadataFactoryInterface;
  17. use ApiPlatform\Core\Util\RequestAttributesExtractor;
  18. use Symfony\Component\HttpKernel\Event\ResponseEvent;
  20. /**
  21.  * Configures cache HTTP headers for the current response.
  22.  *
  23.  * @author Kévin Dunglas <dunglas@gmail.com>
  24.  *
  25.  * @experimental
  26.  */
  27. final class AddHeadersListener
  28. {
  29.     private $etag;
  30.     private $maxAge;
  31.     private $sharedMaxAge;
  32.     private $vary;
  33.     private $public;
  34.     private $resourceMetadataFactory;
  35.     private $staleWhileRevalidate;
  36.     private $staleIfError;
  38.     public function __construct(bool $etag = false, int $maxAge = null, int $sharedMaxAge = null, array $vary = null, bool $public = null, ResourceMetadataFactoryInterface $resourceMetadataFactory = null, int $staleWhileRevalidate = null, int $staleIfError = null)
  39.     {
  40.         $this->etag = $etag;
  41.         $this->maxAge = $maxAge;
  42.         $this->sharedMaxAge = $sharedMaxAge;
  43.         $this->vary = $vary;
  44.         $this->public = $public;
  45.         $this->resourceMetadataFactory = $resourceMetadataFactory;
  46.         $this->staleWhileRevalidate = $staleWhileRevalidate;
  47.         $this->staleIfError = $staleIfError;
  48.     }
  50.     public function onKernelResponse(ResponseEvent $event): void
  51.     {
  52.         $request = $event->getRequest();
  53.         if (!$request->isMethodCacheable()) {
  54.             return;
  55.         }
  57.         $attributes = RequestAttributesExtractor::extractAttributes($request);
  58.         if (\count($attributes) < 1) {
  59.             return;
  60.         }
  62.         $response = $event->getResponse();
  64.         if (!$response->getContent() || !$response->isSuccessful()) {
  65.             return;
  66.         }
  68.         $resourceCacheHeaders = [];
  70.         if ($this->resourceMetadataFactory) {
  71.             $resourceMetadata = $this->resourceMetadataFactory->create($attributes['resource_class']);
  72.             $resourceCacheHeaders = $resourceMetadata->getOperationAttribute($attributes, 'cache_headers', [], true);
  73.         }
  75.         if ($this->etag && !$response->getEtag()) {
  76.             $response->setEtag(md5((string) $response->getContent()));
  77.         }
  79.         if (null !== ($maxAge = $resourceCacheHeaders['max_age'] ?? $this->maxAge) && !$response->headers->hasCacheControlDirective('max-age')) {
  80.             $response->setMaxAge($maxAge);
  81.         }
  83.         $vary = $resourceCacheHeaders['vary'] ?? $this->vary;
  84.         if (null !== $vary) {
  85.             $response->setVary(array_diff($vary, $response->getVary()), false);
  86.         }
  88.         // if the public-property is defined and not yet set; apply it to the response
  89.         $public = ($resourceCacheHeaders['public'] ?? $this->public);
  90.         if (null !== $public && !$response->headers->hasCacheControlDirective('public')) {
  91.             $public ? $response->setPublic() : $response->setPrivate();
  92.         }
  94.         // Cache-Control "s-maxage" is only relevant is resource is not marked as "private"
  95.         if (false !== $public && null !== ($sharedMaxAge = $resourceCacheHeaders['shared_max_age'] ?? $this->sharedMaxAge) && !$response->headers->hasCacheControlDirective('s-maxage')) {
  96.             $response->setSharedMaxAge($sharedMaxAge);
  97.         }
  99.         if (null !== ($staleWhileRevalidate = $resourceCacheHeaders['stale_while_revalidate'] ?? $this->staleWhileRevalidate) && !$response->headers->hasCacheControlDirective('stale-while-revalidate')) {
  100.             $response->headers->addCacheControlDirective('stale-while-revalidate', (string) $staleWhileRevalidate);
  101.         }
  103.         if (null !== ($staleIfError = $resourceCacheHeaders['stale_if_error'] ?? $this->staleIfError) && !$response->headers->hasCacheControlDirective('stale-if-error')) {
  104.             $response->headers->addCacheControlDirective('stale-if-error', (string) $staleIfError);
  105.         }
  106.     }
  107. }