Added

• Added EtagCachePlugin to cache only ETag-backed responses and always revalidate them before serving cached bodies.

• Support Symfony 8.
• Test with PHP 8.5.

• Test with PHP 8.3 and 8.4.

Changed

• Drop support of deprecated PHP-HTTP StreamFactory, only PSR-17 StreamFactoryInterface is now supported.

Version 1

• Allow installation with Symfony 7.

• Avoid PHP warning about serializing resources when serializing the response by detaching the stream.

• Test with PHP 8.1 and 8.2
• Made phpspec tests compatible with PSR-7 2.0 strict typing
• Detect null and use 0 explicitly to calculate expiration

• Allow installation with psr/cache 3.0 (1.0 and 2.0 are still allowed too)

Added

• Allow installation with Symfony 6

Changed

• Be more defensive about cache hits. A cache entry can technically contain null.

Added

• Allow installation with psr/cache 2.0 (1.0 still allowed too)

Added

• Support for PHP 8

Added

• Support for Symfony 5.
• Support for PSR-17 StreamFactoryInterface.
• Added blacklisted_paths option, which takes an array of strings (regular expressions) and allows to define paths, that shall not be cached in any case.

Added

• Support for HTTPlug 2 / PSR-18
• Added cache_listeners option, which takes an array of CacheListeners, who get notified and can optionally act on a Response based on a cache hit or miss event. An implementation, AddHeaderCacheListener, is provided which will add an X-Cache header to the response with this information.

Added

• Support for Symfony 4

Changed

• Removed check if etag is a string. Etag can never be a string, it is always an array.

Added

• CacheKeyGenerator interface that allow you to configure how the PSR-6 cache key is created. There are two implementations of this interface: SimpleGenerator (default) and HeaderCacheKeyGenerator.

Fixed

• Issue where deprecation warning always was triggered. Not it is just triggered if respect_cache_headers is used.

Added

• New methods option which allows to configure the request methods which can be cached.
• New respect_response_cache_directives option to define specific cache directives to respect when handling responses.
• Introduced CachePlugin::clientCache and CachePlugin::serverCache factory methods to easily setup the plugin with the correct config settigns for each usecase.

Changed

• The no-cache directive is now respected by the plugin and will not cache the response. If you need the previous behaviour, configure respect_response_cache_directives.
• We always rewind the stream after loading response from cache.

Deprecated

• The respect_cache_headers option is deprecated and will be removed in 2.0. This option is replaced by the new respect_response_cache_directives option. If you had set respect_cache_headers to false, set the directives to [] to ignore all directives.

Changed

• The default value for default_ttl is changed from null to 0.

Fixed

• Issue when you use respect_cache_headers=>false in combination with default_ttl=>null.
• We allow cache_lifetime to be set to null.

Added

• Support for cache validation with ETag and Last-Modified headers. (Enabled automatically when the server sends the relevant headers.)
• hash_algo config option used for cache key generation (defaults to sha1).

Changed

• Default hash algo used for cache generation (from md5 to sha1).

Fixed

• Cast max age header to integer in order to get valid expiration value.

• Initial release