Skip to content

Latest commit

 

History

History
548 lines (366 loc) · 15.9 KB

CHANGELOG.md

File metadata and controls

548 lines (366 loc) · 15.9 KB
Raw

Changelog

3.x

3.0.2

  • Fixed extension to depend on the DependencyInjection component rather than the HttpKernel.

3.0.1

  • Fixed regression in AttributesListener: Ignore other attributes on controller methods.

3.0.0

  • Minimum PHP version is now 8.1
  • Support Symfony 6.4 and 7
  • Drop obsolete annotations support, use attributes Remove all configuration you have at fos_http_cache.tags.annotations
  • Make fastly and cloudflare clients lazy loaded to support Symfony secrets that are only available at runtime, but not yet when the container is built.
  • Removed deprecated FOS\HttpCacheBundle\UserContext\AnonymousRequestMatcher, use the class from the FOSHttpCache component instead: FOS\HttpCache\UserContext\AnonymousRequestMatcher.
  • Removed obsolete ContextInvalidationLogoutHandler, use ContextInvalidationSessionLogoutHandler instead.
  • Fixed service loading to not fail when Twig is not available.

2.x

2.17.1

  • Fix readthedocs build.

2.17.0

  • Support to configure the fastly CDN client.

2.16.2

  • Catch SessionNotFoundException in FlashMessageListener, as Symfony 6 moved from returning null to throwing an exception.
  • Add : void to commands to avoid warning from Symfony 6.3, prepare for Symfony 7 support.

2.16.1

  • Add : void return to compiler passes to avoid warning from Symfony 6.3, and prepare for Symfony 7 support.

2.16.0

  • Added support for AWS cloudfront, using the jean-beru/fos-http-cache-cloudfront package.

2.15.0

  • Added Cloudflare proxy client.

2.14.0

  • Fix handling of custom glue for response tags. If you use custom glue with the Symfony HttpCache, you can now configure a customized tag header parser on the PurgeTagsListener.

2.13.0

  • Fix Symfony 6 deprecations on the command name configuration.

2.12.1

  • Fix some PHP 8.1 deprecation warnings.

2.12.0

  • Support Symfony 6
  • Drop support for Symfony 3 and 4.3 (keep using 2.11.* for legacy projects).

2.11.2

Fixed

  • Fixed servers_from_jsonenv to actually work with an array.

2.11.1

Fixed

  • Fixed readthedocs.io configuration. This needs a release to show up as the latest doc (which had no longer been updated in quite a while because of build errors)

2.11.0

Added

  • New configuration option servers_from_jsonenv to support a variable amount of proxy servers defined via an environment variable.

2.10.3

Fixed

  • Do not error in InvalidationListener nor TagListener when symfony/expression-language is missing but no expression is used.
  • Properly report missing symfony/expression-language when an expression is used in response configuration.

2.10.2

Fixed

  • The fix about overwriting flash messages on multiple redirects introduced in version 2.9.1 created the risk of losing flash messages when redirecting to a path that is outside the firewall or destroys the session. This version hopefully fixes both cases. Existing flash messages in a request cookie are merged with new flash messages from the session.

2.10.1

Fixed

  • Fix typehint in PHP 8 attributes handling to use ControllerResolverInterface

2.10.0

Changed

  • Adjusted to work with PHP 8
  • Dropped support for PHP 7.2
  • Added support for PHP 8 Attributes

2.9.2

Fixed

  • The fix about overwriting flash messages on multiple redirects introduced in version 2.9.1 created the risk of losing flash messages when redirecting to a path that is outside the firewall or destroys the session. This version hopefully fixes both cases. Existing flash messages in a request cookie are merged with new flash messages from the session.

2.9.1

Fixed

  • Flash messages won't be lost even when redirecting multiple times.

2.9.0

Added

  • New Feature: Command fos:httpcache:clear to clear the whole http cache.

2.8.0

Fixed

  • Adjusted to work with Twig 3
  • Adjusted to work with Symfony 5
  • Allow Httplug 2

2.7.2

Fixed

  • Avoid deprecation warning about ContainerAwareCommand.

2.7.1

Fixed

  • Avoid deprecation warning about TokenInterface::getRoles.
  • Improve exception message if a tag capable client is not found.

2.7.0

Changed

  • Allow to use environment variables to configure the caching proxy.

Fixed

  • Invalidate the user context cache also when impersonating a user and when stopping to impersonate.

2.6.1

Fixed

  • Do not leak the Symfony-Session-NoAutoCacheControl header when the Symfony session system is not enabled.

2.6.0

Changed

  • User context lookup now tags the hash lookup response. The logout listener can now invalidate that tag instead of doing a BAN request. The previous varnish BAN request has been incorrect and banned all cache entries on Varnish. The logout handler is now also activated by default for the Symfony HttpCache in addition to Varnish and Noop.

Fixed

  • Cache Tagging: It is now possible to use cache tagging without installing the SensioFrameworkExtraBundle. There is a new configuration option tags.annotations.enabled that can be set to false.

2.5.1

Fixed

  • Cache Tagging: Clear the SymfonyResponseTagger after we tagged a response. Usually PHP uses a new instance for every request. But for example the hash lookup when using Symfony HttpCache does two requests in the same PHP process.

2.5.0

Added

  • New Feature: Support for the max_header_value_length option to split huge tag lists into multiple headers. #483

Fixed

  • Cache control on Symfony 4.1 now also works when the Vary header for user_context_hash is already present on the response. #485

2.4.1

2.4.0

Added

  • Support for the Varnish xkey vmod for more efficient cache tagging.

  • Autoconfigure support for custom context providers.

  • Autowiring support for the services in this bundle:

    • fos_http_cache.cache_manager => FOS\HttpCacheBundle\CacheManager
    • fos_http_cache.http.symfony_response_tagger => FOS\HttpCacheBundle\Http\SymfonyResponseTagger
    • fos_http_cache.event_listener.cache_control => FOS\HttpCacheBundle\EventListener\CacheControlListener
    • fos_http_cache.proxy_client.default => FOS\HttpCache\ProxyClient\ProxyClient

    The old service names are still available, but using them directly is deprecated.

2.3.1

Fixed

  • Regression in the configuration when you explicitly specified the default proxy client. This started to be reported as error in 2.3.0 and now works again.

2.3.0

Added

  • [Symfony HttpCache] You can now configure the Symfony proxy client to directly call the HttpCache for invalidation requests instead of executing real web requests. Use the new configuration option proxy_client.symfony.use_kernel_dispatcher and follow the instructions in FOSHttpCache to adjust your kernel and bootstrap things accordingly.

2.2.2

Fixed

  • Fix session_listener decoration when session is not enabled.

2.2.1

Fixed

  • Adjust user context listener to handle Symfony 4.1 breaking behaviour change.

2.2.0

Support for Symfony 4. (Note that only the fos_http_cache.cache_manager service is public in Symfony 4. Use dependency injection if you need direct access to other services.)

Added

  • You can now use cache tags and invalidate them with the Symfony HttpCache reverse proxy. You can tweak configuration in the proxy_client.symfony section of the configuration. See the FOSHttpCache documentation for instructions on how to set up the cache.

  • Allow to configure the purge method for the Symfony proxy client.

  • You can now also match requests with regular expressions on the query string. The new option match.query_string is available for cache control rules, tags and invalidation.

  • ETags can now be false, strong or weak by setting headers.etag option to "strong" or "weak" respectively. Value true due to backward compatibility will be resolved as "strong".

Fixed

  • The FlashMessageListener has been broken during refactoring for 2.0 and now works again. Constructor uses an options array.

  • Tag annotations now work with SensioFrameworkExtraBundle 4. An accidental exception prevents using them with FOSHttpCacheBundle 2.0 and 2.1.

  • User context is more reliable not cache when the hash mismatches. (E.g. after login/logout.)

  • The ContextInvalidationLogoutHandler has been deprecated in favor of the ContextInvalidationSessionLogoutHandler. The original handler was called after the invalidation of the session, and thus did not invalidate the session it should have but a newly created one. You should remove the deprecated service fos_http_cache.user_context.logout_handler from the logout.handlers section of your firewall configuration.

  • User context compatibility which was broken due to Symfony making responses private if the session is started as of Symfony 3.4+.

Deprecated

  • Setting up custom services with the commands provided in this bundle has been deprecated. The $commandName constructor argument will be removed in 3.0.

2.1.0

Added

  • Individual rules in the cache_control can now again have a match_response or additional_response_status configuration to limit the rule to certain responses.

    For this, the signature of CacheControlListener::addRule had to be changed. It now expects a RuleMatcherInterface instead of the ResponseMatcherInterface. If you extended the listener or change the service configuration, this could be a BC BREAK for your application.

Fixed

  • If no response matching is configured on cache_control, the global cacheable configuration is now respected to decide whether cache headers should be set. By default, this follows RFC 7234, only responses with status 200, 203, 204, 206, 300, 301, 404, 405, 410, 414 or 501 get cache headers.

    We decided to consider this a bugfix, but if your relied on this behaviour it will be a BC BREAK for your application.

2.0.0

General

  • Updated the version of FOSHttpCache to 2.0.0. See the FOSHttpCache changelog for more information. Most importantly, we removed the hard coupling on the Guzzle HTTP client (using HTTPlug). Your composer.json now needs to specify which HTTP client to install; see the installation instructions
  • Deprecated methods have been removed.

Proxy client

  • The configuration for the proxy client has been adjusted. Proxy servers are now configured under http and servers must be a list - a comma separated string of server IPs is no longer supported.

Event listeners

  • BC break: the UserContextListener constructor signature was changed to take an array of options.
  • BC break: renamed the event listener classes to XyzListener.

Rule matcher

  • BC break: The match_response and additional_cacheable_status configuration parameters were removed for individual match rules. Note that match_response and additional_response_status have been re-added for cache_control in 2.0.1.

  • BC break: The second argument of the RuleMatcher constructor was changed to take a ResponseMatcherInterface.

  • Cacheable status codes are now configured globally (cacheable.response.additional_status or cacheable.response.expression).

Tags

  • BC break: The TagHandler has been split. Invalidating tags happens through CacheManager::invalidateTags (if you use annotations for tag invalidation, you don't need to change anything). Recording tags and writing them into the responses is now done through the SymfonyResponseTagger. The service fos_http_cache.handler.tag_handler no longer exists. For tagging responses, use fos_http_cache.http.symfony_response_tagger instead, and to invalidate tags use the service fos_http_cache.cache_manager.
  • BC break: The configuration tags.header has been removed. Configuring the header for tagging responses is now done at tags.response_header. Configuring the header for tag invalidation requests is now done at proxy_client.varnish.tags_header.

Tests

  • BC break: Dropped the proxy client services as they where not used anywhere. The services fos_http_cache.test.client.varnish and fos_http_cache.test.client.nginx no longer exist.

User context

  • Added an option always_vary_on_context_hash to make it possible to disable automatically setting the vary headers for the user hash.

1.3.16

1.3.15

  • Fix session_listener decoration when session is not enabled.

1.3.14

  • User context compatibility which was broken due to Symfony making responses private if the session is started as of Symfony 3.4+.

1.3.13

  • Symfony HttpCache User Context: Move the AnonymousRequestMatcher to FOSHttpCache.

    The recommended way to ignore cookie based sessions is to set session_name_prefix to false rather than omit the Cookie header from user_identifier_headers.

1.3.12

  • Prevent potential accidental caching on user context hash mismatch (particularly with symfony HttpCache).

1.3.11

  • #395 : Compatibility with SensioFrameworkExtraBundle 4.

1.3.10

  • Avoid calling deprecated method in Symfony 3.2.

1.3.9

  • Fix configuration handling when only custom proxy client is configured.

1.3.8

  • Do not sanity check hash on anonymous requests.

1.3.7

  • Add a sanity check on UserContextHash to avoid invalid content being cached (example: anonymous cache set for authenticated user). This scenario occures when the UserContextHash is cached by Varnish via fos_http_cache.user_context.hash_cache_ttl > 0 and the session is lost via garbage collector. The data given is the anonymous one despite having a hash for authenticated, all authenticated users will then have the anonymous version. Same problem could occurs with users having is role changed or anything else that can modify the hash.

1.3.2

  • Fixed some status codes (such as 204 and 302) not triggering invalidation.

1.3.1

  • Fixed configuration handling with symfony and nginx cache client. Cache tagging is now immediately reported to not work with those clients.

1.3.0

  • Added configuration for Symfony HttpCache client and HttpCache now loads purge and refresh handlers by default.
  • Configured/annotated cache tags on subrequests (in Twig: render(controller())) are no longer ignored. Additionally, it is now possible to add tags from code before the response object has been created, by using the TagHandler, and from Twig with the fos_httpcache_tag function. If you defined custom services for the InvalidateTagCommand, you should now inject the TagHandler instead of the CacheManager.
  • deprecated CacheManager::tagResponse in favor of TagHandler::addTags
  • Added configuration option for custom proxy client (#208)
  • Added support for a simple Etag header in the header configuration (#207)

1.2.0

  • Refactored the Symfony built-in HttpCache support to be extensible. FOS\HttpCacheBundle\HttpCache is deprecated in favor of EventDispatchingHttpCache.

    BC break: If you overwrite cleanupForwardRequest in your cache kernel, you need to extend FOS\HttpCache\SymfonyCache\UserContextSubscriber and move that logic to the method cleanupHashLookupRequest in there.

1.1.0

  • Allow cache headers overwrite.
  • Added support for the user context lookup with Symfony built-in reverse proxy, aka HttpCache.

1.0.0

Initial release. To migrate from other Symfony2 cache bundles, see LiipCacheControlBundle or DriebitHttpCacheBundle.