class CacheableResponse in Zircon Profile 8

A response that contains and can expose cacheability metadata.

Supports Drupal's caching concepts: cache tags for invalidation and cache contexts for variations.

Hierarchy

• class \Symfony\Component\HttpFoundation\Response
  • class \Drupal\Core\Cache\CacheableResponse implements CacheableResponseInterface uses CacheableResponseTrait

See also

\Drupal\Core\Cache\Cache

\Drupal\Core\Cache\CacheableMetadata

\Drupal\Core\Cache\CacheableResponseTrait

6 files declare their use of CacheableResponse

DynamicPageCacheTestController.php in core/modules/dynamic_page_cache/tests/dynamic_page_cache_test/src/DynamicPageCacheTestController.php

Contains \Drupal\dynamic_page_cache_test\DynamicPageCacheTestController.

Feed.php in core/modules/views/src/Plugin/views/display/Feed.php

Contains \Drupal\views\Plugin\views\display\Feed.

PageCacheAcceptHeaderController.php in core/modules/system/tests/modules/system_test/src/Controller/PageCacheAcceptHeaderController.php

Contains \Drupal\system_test\Controller\PageCacheAcceptHeaderController.

RestExport.php in core/modules/rest/src/Plugin/views/display/RestExport.php

Contains \Drupal\rest\Plugin\views\display\RestExport.

SystemTestController.php in core/modules/system/tests/modules/system_test/src/Controller/SystemTestController.php

Contains \Drupal\system_test\Controller\SystemTestController.

... See full list

File

core/lib/Drupal/Core/Cache/CacheableResponse.php, line 22

Contains \Drupal\Core\Cache\CacheableResponse.

Namespace

Drupal\Core\Cache

class CacheableResponse extends Response implements CacheableResponseInterface {
  use CacheableResponseTrait;

}

Members

Name	Modifiers	Type	Description	Overrides
CacheableResponseTrait::$cacheabilityMetadata	protected	property	The cacheability metadata.
CacheableResponseTrait::addCacheableDependency	public	function
CacheableResponseTrait::getCacheableMetadata	public	function
Response::$charset	protected	property
Response::$content	protected	property
Response::$headers	public	property
Response::$statusCode	protected	property
Response::$statusText	protected	property
Response::$statusTexts	public static	property	Status codes translation table.
Response::$version	protected	property
Response::closeOutputBuffers	public static	function	Cleans or flushes output buffers up to target level.
Response::create	public static	function	Factory method for chainability.	4
Response::ensureIEOverSSLCompatibility	protected	function	Checks if we need to remove Cache-Control for SSL encrypted downloads when using IE < 9.
Response::expire	public	function	Marks the response stale by setting the Age header to be equal to the maximum age of the response.
Response::getAge	public	function	Returns the age of the response.
Response::getCharset	public	function	Retrieves the response charset.
Response::getContent	public	function	Gets the current response content.	2
Response::getDate	public	function	Returns the Date header as a DateTime instance.
Response::getEtag	public	function	Returns the literal value of the ETag HTTP header.
Response::getExpires	public	function	Returns the value of the Expires header as a DateTime instance.
Response::getLastModified	public	function	Returns the Last-Modified HTTP header as a DateTime instance.
Response::getMaxAge	public	function	Returns the number of seconds after the time specified in the response's Date header when the response should no longer be considered fresh.
Response::getProtocolVersion	public	function	Gets the HTTP protocol version.
Response::getStatusCode	public	function	Retrieves the status code for the current web response.
Response::getTtl	public	function	Returns the response's time-to-live in seconds.
Response::getVary	public	function	Returns an array of header names given in the Vary header.
Response::hasVary	public	function	Returns true if the response includes a Vary header.
Response::HTTP_ACCEPTED		constant
Response::HTTP_ALREADY_REPORTED		constant
Response::HTTP_BAD_GATEWAY		constant
Response::HTTP_BAD_REQUEST		constant
Response::HTTP_CONFLICT		constant
Response::HTTP_CONTINUE		constant
Response::HTTP_CREATED		constant
Response::HTTP_EXPECTATION_FAILED		constant
Response::HTTP_FAILED_DEPENDENCY		constant
Response::HTTP_FORBIDDEN		constant
Response::HTTP_FOUND		constant
Response::HTTP_GATEWAY_TIMEOUT		constant
Response::HTTP_GONE		constant
Response::HTTP_IM_USED		constant
Response::HTTP_INSUFFICIENT_STORAGE		constant
Response::HTTP_INTERNAL_SERVER_ERROR		constant
Response::HTTP_I_AM_A_TEAPOT		constant
Response::HTTP_LENGTH_REQUIRED		constant
Response::HTTP_LOCKED		constant
Response::HTTP_LOOP_DETECTED		constant
Response::HTTP_METHOD_NOT_ALLOWED		constant
Response::HTTP_MOVED_PERMANENTLY		constant
Response::HTTP_MULTIPLE_CHOICES		constant
Response::HTTP_MULTI_STATUS		constant
Response::HTTP_NETWORK_AUTHENTICATION_REQUIRED		constant
Response::HTTP_NON_AUTHORITATIVE_INFORMATION		constant
Response::HTTP_NOT_ACCEPTABLE		constant
Response::HTTP_NOT_EXTENDED		constant
Response::HTTP_NOT_FOUND		constant
Response::HTTP_NOT_IMPLEMENTED		constant
Response::HTTP_NOT_MODIFIED		constant
Response::HTTP_NO_CONTENT		constant
Response::HTTP_OK		constant
Response::HTTP_PARTIAL_CONTENT		constant
Response::HTTP_PAYMENT_REQUIRED		constant
Response::HTTP_PERMANENTLY_REDIRECT		constant
Response::HTTP_PRECONDITION_FAILED		constant
Response::HTTP_PRECONDITION_REQUIRED		constant
Response::HTTP_PROCESSING		constant
Response::HTTP_PROXY_AUTHENTICATION_REQUIRED		constant
Response::HTTP_REQUESTED_RANGE_NOT_SATISFIABLE		constant
Response::HTTP_REQUEST_ENTITY_TOO_LARGE		constant
Response::HTTP_REQUEST_HEADER_FIELDS_TOO_LARGE		constant
Response::HTTP_REQUEST_TIMEOUT		constant
Response::HTTP_REQUEST_URI_TOO_LONG		constant
Response::HTTP_RESERVED		constant
Response::HTTP_RESERVED_FOR_WEBDAV_ADVANCED_COLLECTIONS_EXPIRED_PROPOSAL		constant
Response::HTTP_RESET_CONTENT		constant
Response::HTTP_SEE_OTHER		constant
Response::HTTP_SERVICE_UNAVAILABLE		constant
Response::HTTP_SWITCHING_PROTOCOLS		constant
Response::HTTP_TEMPORARY_REDIRECT		constant
Response::HTTP_TOO_MANY_REQUESTS		constant
Response::HTTP_UNAUTHORIZED		constant
Response::HTTP_UNPROCESSABLE_ENTITY		constant
Response::HTTP_UNSUPPORTED_MEDIA_TYPE		constant
Response::HTTP_UPGRADE_REQUIRED		constant
Response::HTTP_USE_PROXY		constant
Response::HTTP_VARIANT_ALSO_NEGOTIATES_EXPERIMENTAL		constant
Response::HTTP_VERSION_NOT_SUPPORTED		constant
Response::isCacheable	public	function	Returns true if the response is worth caching under any circumstance.
Response::isClientError	public	function	Is there a client error?
Response::isEmpty	public	function	Is the response empty?
Response::isForbidden	public	function	Is the response forbidden?
Response::isFresh	public	function	Returns true if the response is "fresh".
Response::isInformational	public	function	Is response informative?
Response::isInvalid	public	function	Is response invalid?
Response::isNotFound	public	function	Is the response a not found error?
Response::isNotModified	public	function	Determines if the Response validators (ETag, Last-Modified) match a conditional value specified in the Request.
Response::isOk	public	function	Is the response OK?
Response::isRedirect	public	function	Is the response a redirect of some form?
Response::isRedirection	public	function	Is the response a redirect?
Response::isServerError	public	function	Was there a server side error?
Response::isSuccessful	public	function	Is response successful?
Response::isValidateable	public	function	Returns true if the response includes headers that can be used to validate the response with the origin server using a conditional GET request.
Response::mustRevalidate	public	function	Returns true if the response must be revalidated by caches.
Response::prepare	public	function	Prepares the Response before it is sent to the client.	1
Response::send	public	function	Sends HTTP headers and content.
Response::sendContent	public	function	Sends content for the current web response.	2
Response::sendHeaders	public	function	Sends HTTP headers.
Response::setCache	public	function	Sets the response's cache headers (validation and/or expiration).
Response::setCharset	public	function	Sets the response charset.
Response::setClientTtl	public	function	Sets the response's time-to-live for private/client caches.
Response::setContent	public	function	Sets the response content.	3
Response::setDate	public	function	Sets the Date header.
Response::setEtag	public	function	Sets the ETag value.
Response::setExpires	public	function	Sets the Expires HTTP header with a DateTime instance.
Response::setLastModified	public	function	Sets the Last-Modified HTTP header with a DateTime instance.
Response::setMaxAge	public	function	Sets the number of seconds after which the response should no longer be considered fresh.
Response::setNotModified	public	function	Modifies the response so that it conforms to the rules defined for a 304 status code.
Response::setPrivate	public	function	Marks the response as "private".
Response::setProtocolVersion	public	function	Sets the HTTP protocol version (1.0 or 1.1).
Response::setPublic	public	function	Marks the response as "public".
Response::setSharedMaxAge	public	function	Sets the number of seconds after which the response should no longer be considered fresh by shared caches.
Response::setStatusCode	public	function	Sets the response status code.
Response::setTtl	public	function	Sets the response's time-to-live for shared caches.
Response::setVary	public	function	Sets the Vary header.
Response::__clone	public	function	Clones the current Response instance.
Response::__construct	public	function	Constructor.	10
Response::__toString	public	function	Returns the Response as an HTTP string.