CookiesCacheContext.php

Same filename in other branches
  1. 9 core/lib/Drupal/Core/Cache/Context/CookiesCacheContext.php
  2. 10 core/lib/Drupal/Core/Cache/Context/CookiesCacheContext.php
  3. 11.x core/lib/Drupal/Core/Cache/Context/CookiesCacheContext.php

Namespace

Drupal\Core\Cache\Context

File

core/lib/Drupal/Core/Cache/Context/CookiesCacheContext.php

View source
<?php

namespace Drupal\Core\Cache\Context;

use Drupal\Core\Cache\CacheableMetadata;

/**
 * Defines the CookiesCacheContext service, for "per cookie" caching.
 *
 * Cache context ID: 'cookies' (to vary by all cookies).
 * Calculated cache context ID: 'cookies:%name', e.g. 'cookies:device_type' (to
 * vary by the 'device_type' cookie).
 */
class CookiesCacheContext extends RequestStackCacheContextBase implements CalculatedCacheContextInterface {
    
    /**
     * {@inheritdoc}
     */
    public static function getLabel() {
        return t('HTTP cookies');
    }
    
    /**
     * {@inheritdoc}
     */
    public function getContext($cookie = NULL) {
        if ($cookie === NULL) {
            return $this->requestStack
                ->getCurrentRequest()->cookies
                ->all();
        }
        else {
            return $this->requestStack
                ->getCurrentRequest()->cookies
                ->get($cookie);
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function getCacheableMetadata($cookie = NULL) {
        return new CacheableMetadata();
    }

}

Classes

Title Deprecated Summary
CookiesCacheContext Defines the CookiesCacheContext service, for "per cookie" caching.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.