CHANGELOG.md

Changelog

All notable changes to laravel-responsecache will be documented in this file.

8.2.0 - 2026-02-22

What's Changed

• Add Laravel 13 and PHP 8.5 support by @freekmurze in spatie#511
• Use spatie/php-attribute-reader by @freekmurze in spatie#512

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/8.1.0...8.2.0

8.1.0 - 2026-02-16

What's Changed

• Switch SVG diagrams to light theme for readable text on docs
• Add responsecache development skill

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/8.0.0...8.1.0

8.0.0 - 2026-02-16

What's Changed

• Add support for PHP 8.4 and Laravel 12
• Drop support for PHP 8.3 and below
• Drop support for Laravel 11 and below
• Add flexible caching via FlexibleCacheResponse middleware — serves stale responses instantly while refreshing the cache in the background
• Add PHP attributes (#[Cache], #[FlexibleCache], #[NoCache]) for controller-level cache configuration
• Rename event classes to use Event suffix (e.g. CacheMissed → CacheMissedEvent)
• Replace cacheRequestUntil() with cacheLifetimeInSeconds() in CacheProfile interface
• Replace CacheResponse::using() with CacheResponse::for() and FlexibleCacheResponse::for()
• Improved debug headers configuration
• Fix return types in Facade PHPDoc for clear() and forget()

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.7.2...8.0.0

7.7.2 - 2025-08-28

What's Changed

• Fix Carbon3 diffInSeconds to use int and not float by @it-can in spatie#500
• Bump actions/checkout from 4 to 5 by @dependabot[bot] in spatie#498
• Bump stefanzweifel/git-auto-commit-action from 5.2.0 to 6.0.1 by @dependabot[bot] in spatie#496

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.7.1...7.7.2

7.7.1 - 2025-07-17

What's Changed

• Introduce using() method to conveniently define lifetime and tags by @kamilkozak in spatie#491

New Contributors

• @kamilkozak made their first contribution in spatie#491

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.7.0...7.7.1

7.7.0 - 2025-05-20

What's Changed

• Bump stefanzweifel/git-auto-commit-action from 5.1.0 to 5.2.0 by @dependabot in spatie#493
• Bump dependabot/fetch-metadata from 2.3.0 to 2.4.0 by @dependabot in spatie#494
• [8.0] Introduce ClearingResponseCacheFailed and return boolean by clear() by @alies-dev in spatie#495

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.6.5...7.7.0

7.6.5 - 2025-04-10

What's Changed

• fix DocBlock in ResponseCache Facade by @ricventu in spatie#492

New Contributors

• @ricventu made their first contribution in spatie#492

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.6.4...7.6.5

7.6.4 - 2025-02-25

What's Changed

• Bump stefanzweifel/git-auto-commit-action from 5.0.1 to 5.1.0 by @dependabot in spatie#487
• Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in spatie#488
• Add compatibility for Laravel 12. by @mazedlx in spatie#490

New Contributors

• @mazedlx made their first contribution in spatie#490

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.6.3...7.6.4

7.6.3 - 2024-12-11

What's Changed

• Fix ResponseCache Facade docblock for forget() by @alexcanana in spatie#486

New Contributors

• @alexcanana made their first contribution in spatie#486

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.6.2...7.6.3

7.6.2 - 2024-12-09

What's Changed

• CsrfTokenReplacer avoid str_replace(): by @thyseus in spatie#482

New Contributors

• @thyseus made their first contribution in spatie#482

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.6.1...7.6.2

7.6.1 - 2024-11-18

What's Changed

• Add PHPDoc for ResponseCache Facade by @alies-dev in spatie#485

New Contributors

• @alies-dev made their first contribution in spatie#485

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.6.0...7.6.1

7.6.0 - 2024-08-05

What's Changed

• Bump stefanzweifel/git-auto-commit-action from 5.0.0 to 5.0.1 by @dependabot in spatie#470
• Fix incorrect grammar by @SebKay in spatie#472
• Add missing Laravel 11.x Documentation by @omaratpxt in spatie#474
• Bump dependabot/fetch-metadata from 1.6.0 to 2.2.0 by @dependabot in spatie#475
• Switch DefaultHasher to xxh128 for a faster alternative to MD5. by @marcell-ferenc in spatie#478

New Contributors

• @SebKay made their first contribution in spatie#472
• @omaratpxt made their first contribution in spatie#474
• @marcell-ferenc made their first contribution in spatie#478

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.5.2...7.6.0

7.5.2 - 2024-04-03

What's Changed

• Cast cache lifetime to integer by default by @dwightwatson in spatie#468

New Contributors

• @dwightwatson made their first contribution in spatie#468

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.5.1...7.5.2

7.5.1 - 2024-03-23

• allow Carbon 3

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.5.0...7.5.1

7.5.0 - 2024-03-11

What's Changed

• Add php 8.3 matrix by @binbyz in spatie#460
• Support Laravel 11

New Contributors

• @binbyz made their first contribution in spatie#460

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.4.10...7.5.0

7.4.10 - 2023-10-28

What's Changed

• Bump actions/checkout from 3 to 4 by @dependabot in spatie#449
• Bump stefanzweifel/git-auto-commit-action from 4.16.0 to 5.0.0 by @dependabot in spatie#452
• Do not enable cache time header by default by @francoism90 in spatie#456

New Contributors

• @francoism90 made their first contribution in spatie#456

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.4.9...7.4.10

7.4.9 - 2023-10-02

• Fix docblock

7.4.8 - 2023-09-27

What's Changed

• Change PHPDoc for method clear(array ) in Facade by @kra-so in spatie#451

New Contributors

• @gomzyakov made their first contribution in spatie#437
• @kra-so made their first contribution in spatie#451

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.4.7...7.4.8

7.4.7 - 2023-04-07

What's Changed

• Bump dependabot/fetch-metadata from 1.3.5 to 1.3.6 by @dependabot in spatie#427
• Property name changed by @Fot0n in spatie#428
• Typo fix in config responsecache by @dorqa95 in spatie#431
• Issue #342: CacheResponse race condition with has and get by @swichers in spatie#434

New Contributors

• @Fot0n made their first contribution in spatie#428
• @dorqa95 made their first contribution in spatie#431
• @swichers made their first contribution in spatie#434

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.4.6...7.4.7

7.4.6 - 2023-01-23

• add support for L10

7.4.5 - 2023-01-23

What's Changed

• Bump stefanzweifel/git-auto-commit-action from 4.15.4 to 4.16.0 by @dependabot in spatie#424
• Normalize query string parameters before hashing by @cosmastech in spatie#426

New Contributors

• @cosmastech made their first contribution in spatie#426

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.4.4...7.4.5

7.4.4 - 2022-11-25

What's Changed

• Refactor tests to pest by @AyoobMH in spatie#418
• Add PHP 8.2 Support to tests workflow by @patinthehat in spatie#421
• Add Dependabot Automation by @patinthehat in spatie#420
• Bump actions/checkout from 2 to 3 by @dependabot in spatie#423
• Bump stefanzweifel/git-auto-commit-action from 2.3.0 to 4.15.4 by @dependabot in spatie#422
• Catch CouldNotUnserialize exception and continue returning a response by @roberttolton in spatie#408

New Contributors

• @AyoobMH made their first contribution in spatie#418
• @dependabot made their first contribution in spatie#423
• @roberttolton made their first contribution in spatie#408

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.4.3...7.4.4

7.4.3 - 2022-09-24

What's Changed

• Dispatch clear events when using facade by @mateusjunges in spatie#413

New Contributors

• @mateusjunges made their first contribution in spatie#413

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.4.2...7.4.3

7.4.2 - 2022-09-02

What's Changed

• Always prepend app url to requests by @apeisa in spatie#409

New Contributors

• @apeisa made their first contribution in spatie#409

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.4.1...7.4.2

7.4.1 - 2022-08-09

What's Changed

• Cache bypass header now also prevents an already cached response from being returned by @fgilio in spatie#407

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.4.0...7.4.1

7.4.0 - 2022-08-01

What's Changed

• Add cache bypass header by @fgilio in spatie#406

New Contributors

• @fgilio made their first contribution in spatie#406

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.3.1...7.4.0

7.3.1 - 2022-05-30

What's Changed

• Handle missed cache gracefully by @antennaio in spatie#383

New Contributors

• @antennaio made their first contribution in spatie#383

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.3.0...7.3.1

7.3.0 - 2022-05-16

What's Changed

• Add option to output cache age header by @it-can in spatie#385

New Contributors

• @it-can made their first contribution in spatie#385

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/7.2.0...7.3.0

7.2.0 - 2022-01-13

• support Laravel 9

7.1.0 - 2021-04-27

• add CacheItemSelector

7.0.1 - 2021-04-13

• add url option to ClearCommand (#348)

7.0.0 - 2021-04-02

• require PHP 8+
• drop support for PHP 7.x
• use PHP 8 syntax where possible

6.6.9 - 2021-03-30

• fix for issue #331 (#344)

6.6.8 - 2020-01-25

• use package service provider

6.6.7 - 2020-11-28

• add support for PHP 8

6.6.6 - 2020-09-27

• fix clearing tagged cache

6.6.5 - 2020-09-22

• fix tagged responsecache:clear (#316)

6.6.4 - 2020-09-09

• Support Laravel 8

6.6.3 - 2020-08-24

• replace Laravel/framework with individual packages (#304)

6.6.2 - 2020-06-03

• support JSON types other than application/json (#299)

6.6.1 - 2020-04-22

• change to the proper way of setting app URL on runtime (#290)

6.6.0 - 2020-03-02

• drop support for Laravel 6 to fix the test suite (namespace of TestResponse has changed)

6.5.0 - 2020-03-02

• add support for Laravel 7

6.4.0 - 2019-12-01

• drop support for all non-current PHP and Laravel versions

6.3.0 - 2019-09-01

• add support for custom serializers

6.2.1 - 2020-03-07

• make compatible with Laravel 7, so the package can be used on PHP 7.3

6.2.0 - 2019-09-01

• make compatible with Laravel 6

6.1.1 - 2019-08-08

• restore laravel 5.7 compatibility

6.1.0 - 2019-08-01

• add support for cache tags

6.0.2 - 2019-07-31

• make json responses cacheable

6.0.1 - 2019-07-09

• use Rfc2822S formatted date in cache time header

6.0.0 - 2019-05-20

• added support for replacers
• you can now swap out RequestHasher in favor of a custom one
• CacheAllSuccessfulGetRequests will only cache responses of which the content type starts with text
• removed deprecated Flush command
• \Spatie\ResponseCache\ResponseCacheFacade has been removed
• dropped support for carbon v1
• dropped support for PHP 7.2

5.0.3 - 2019-05-10

• make sure the request starts with the app url - fixes #177

5.0.2 - 2019-04-05

• make host specific caches

5.0.1 - 2019-03-15

• fix cache lifetime in config file

5.0.0 - 2019-02-27

• drop support for Laravel 5.7 and lower
• drop support for PHP 7.0 and lower
• change all cache time parameters to seconds (see UPGRADING.md)

4.4.5 - 2019-02-27

• add support for Laravel 5.8
• you can no longer add multiple CacheResponse middleware to one route

4.4.4 - 2018-09-23

• fix for caching urls with query parameters

4.4.3 - 2018-09-23

• fix for forgetting a specific url

4.4.2 - 2018-08-24

• add support for Laravel 5.7

4.4.1 - 2018-07-26

• fix for issue #123

4.4.0 - 2018-04-30

• add support for Lumen

4.3.0 - 2018-03-01

• add forget

4.2.1 - 2018-02-08

• add support for L5.6

4.2.0 - 2018-01-30

• Added: clear() method and responsecache:clear command
• Deprecated: flush() method and responsecache:flush command

Deprecated features will still work until the next major version.

4.1.1 - 2018-01-30

• Added: Better exception handling when something goes wrong unserializing the response

4.1.0 - 2017-09-26

• Added: Support for specific lifetimes on routes

4.0.1 - 2017-08-30

• Fixed: Artisan command registration

4.0.0 - 2017-08-30

• Added: Support for Laravel 5.5
• Removed: Support for all older Laravel versions
• Changed: Renamed facade class

3.2.0 - 2017-06-19

• Added: Support for BinaryFileResponse

3.1.0 - 2017-04-28

• Added: Support for taggable cache

3.0.1 - 2017-03-16

• Fixed: Php version dependency in composer.json

3.0.0 - 2017-03-16

• Added: enabled method on cache profiles
• Added: Events
• Changed: Middleware won't automatically be registered anymore
• Changed: Renamed config file
• Changed: Renamed various methods for readability
• Removed: Dropped PHP 5.6 support

2.0.0 - 2017-01-24

• Added: Support for Laravel 5.4
• Removed: Dropped support for all older Laravel versions

1.1.7 - 2016-10-10

• Added: Usage of RESPONSE_CACHE_LIFETIME env var to config file

1.1.6 - 2016-08-07

• Changed: Debug headers will not be sent when APP_DEBUG is set to false

1.1.5 - 2015-08-28

• Fixed: Issue where the cache middleware couldn't correctly determine the currently authenticated user

1.1.4 - 2015-08-12

• Fixed: An issue where cached request were still served even if the package was disabled via the config file

1.1.3 - 2015-08-11

• Fixed: An issue where the cache header could not be set

1.1.2 - 2015-07-22

• Fixed: BaseCacheProfile has been made abstract (as it should have been all along)

1.1.1 - 2015-07-20

• Fixed: Default cachetime

1.1.0 - 2015-07-20

• Added: A command to flush the response cache

1.0.0 - 2015-07-20

• Initial release