class UrlCacheContext extends RequestStackCacheContextBase implements CacheContextInterface (View source)

Defines the UrlCacheContext service, for "per page" caching.

Cache context ID: 'url'.

Properties

protected RequestStack $requestStack

The request stack.

from  RequestStackCacheContextBase

Methods

__construct(RequestStack $request_stack)

Constructs a new RequestStackCacheContextBase class.

static string
getLabel()

Returns the label of the cache context.

string
getContext()

Returns the string representation of the cache context.

getCacheableMetadata()

Gets the cacheability metadata for the context.

Details

__construct(RequestStack $request_stack)

Constructs a new RequestStackCacheContextBase class.

Parameters

RequestStack $request_stack

The request stack.

static string getLabel()

Returns the label of the cache context.

Return Value

string

The label of the cache context.

string getContext()

Returns the string representation of the cache context.

A cache context service's name is used as a token (placeholder) cache key, and is then replaced with the string returned by this method.

Return Value

string

The string representation of the cache context.

CacheableMetadata getCacheableMetadata()

Gets the cacheability metadata for the context.

There are three valid cases for the returned CacheableMetadata object:

  • An empty object means this can be optimized away safely.
  • A max-age of 0 means that this context can never be optimized away. It will never bubble up and cache tags will not be used.
  • Any non-zero max-age and cache tags will bubble up into the cache item if this is optimized away to allow for invalidation if the context value changes.

Return Value

CacheableMetadata

A cacheable metadata object.