Laravel Responsecache Laravel Package

What's Changed

• Fix forgetting multiple urls stopping at the first uncached url by @freekmurze in https://github.com/spatie/laravel-responsecache/pull/521

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/8.4.0...8.4.1

What's Changed

• Bump dependabot/fetch-metadata from 3.0.0 to 3.1.0 by @dependabot[bot] in https://github.com/spatie/laravel-responsecache/pull/519
• Treat null cache value as a miss to fix has/get race by @mattiasgeniar in https://github.com/spatie/laravel-responsecache/pull/520

New Contributors

• @mattiasgeniar made their first contribution in https://github.com/spatie/laravel-responsecache/pull/520

Full Changelog: https://github.com/spatie/laravel-responsecache/compare/8.3.1...8.4.0

• Fix state sharing in CacheResponse middleware between handle() and terminate() when the middleware is not resolved as the same instance. State now travels on the request attributes. (#518)

What's Changed

• Fix: defer cache storage to terminate() to include post-response modifications by @eguiluz in https://github.com/spatie/laravel-responsecache/pull/513

New Contributors

• @eguiluz made their first contribution in https://github.com/spatie/laravel-responsecache/pull/513

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

What's Changed

• Add Laravel 13 and PHP 8.5 support by @freekmurze in https://github.com/spatie/laravel-responsecache/pull/511
• Use spatie/php-attribute-reader by @freekmurze in https://github.com/spatie/laravel-responsecache/pull/512

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

What's Changed

• Add Laravel 13 support

What's new

Flexible caching

For pages where brief staleness is acceptable, you can now use flexible caching. After the lifetime expires, the stale response is still served instantly while the cache refreshes in the background. Once the grace period is over, the cache is considered expired and the next request will be fully recalculated:

use Spatie\ResponseCache\Middlewares\FlexibleCacheResponse;

Route::get('/dashboard', [DashboardController::class, 'index'])
    ->middleware(FlexibleCacheResponse::for(lifetime: hours(1), grace: minutes(5)));

PHP attributes for cache configuration

You can now use attributes on controllers instead of middleware parameters:

use Spatie\ResponseCache\Attributes\Cache;
use Spatie\ResponseCache\Attributes\FlexibleCache;
use Spatie\ResponseCache\Attributes\NoCache;

#[Cache(lifetime: 3600, tags: ['dashboard'])]
public function index() { ... }

#[FlexibleCache(lifetime: 3600, grace: 300)]
public function show() { ... }

#[NoCache]
public function admin() { ... }

Other changes

• Add support for PHP 8.4 and Laravel 12
• Drop support for PHP 8.3 and below, Laravel 11 and below
• 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

What's Changed

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

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

What's Changed

• Introduce using() method to conveniently define lifetime and tags by @kamilkozak in https://github.com/spatie/laravel-responsecache/pull/491

New Contributors

• @kamilkozak made their first contribution in https://github.com/spatie/laravel-responsecache/pull/491

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

What's Changed

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

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

What's Changed

• fix DocBlock in ResponseCache Facade by @ricventu in https://github.com/spatie/laravel-responsecache/pull/492

New Contributors

• @ricventu made their first contribution in https://github.com/spatie/laravel-responsecache/pull/492

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

What's Changed

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

New Contributors

• @mazedlx made their first contribution in https://github.com/spatie/laravel-responsecache/pull/490

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

What's Changed

• Fix ResponseCache Facade docblock for forget() by @alexcanana in https://github.com/spatie/laravel-responsecache/pull/486

New Contributors

• @alexcanana made their first contribution in https://github.com/spatie/laravel-responsecache/pull/486

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

What's Changed

• CsrfTokenReplacer avoid str_replace(): by @thyseus in https://github.com/spatie/laravel-responsecache/pull/482

New Contributors

• @thyseus made their first contribution in https://github.com/spatie/laravel-responsecache/pull/482

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

What's Changed

• Add PHPDoc for ResponseCache Facade by @alies-dev in https://github.com/spatie/laravel-responsecache/pull/485

New Contributors

• @alies-dev made their first contribution in https://github.com/spatie/laravel-responsecache/pull/485

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

What's Changed

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

New Contributors

• @SebKay made their first contribution in https://github.com/spatie/laravel-responsecache/pull/472
• @omaratpxt made their first contribution in https://github.com/spatie/laravel-responsecache/pull/474
• @marcell-ferenc made their first contribution in https://github.com/spatie/laravel-responsecache/pull/478

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

What's Changed

• Cast cache lifetime to integer by default by @dwightwatson in https://github.com/spatie/laravel-responsecache/pull/468

New Contributors

• @dwightwatson made their first contribution in https://github.com/spatie/laravel-responsecache/pull/468

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

• allow Carbon 3

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

What's Changed

• Add php 8.3 matrix by @binbyz in https://github.com/spatie/laravel-responsecache/pull/460
• Support Laravel 11

New Contributors

• @binbyz made their first contribution in https://github.com/spatie/laravel-responsecache/pull/460

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

What's Changed

• Bump actions/checkout from 3 to 4 by @dependabot in https://github.com/spatie/laravel-responsecache/pull/449
• Bump stefanzweifel/git-auto-commit-action from 4.16.0 to 5.0.0 by @dependabot in https://github.com/spatie/laravel-responsecache/pull/452
• Do not enable cache time header by default by @francoism90 in https://github.com/spatie/laravel-responsecache/pull/456

New Contributors

• @francoism90 made their first contribution in https://github.com/spatie/laravel-responsecache/pull/456

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

• Fix docblock

What's Changed

• Change PHPDoc for method clear(array ) in Facade by @kra-so in https://github.com/spatie/laravel-responsecache/pull/451

New Contributors

• @gomzyakov made their first contribution in https://github.com/spatie/laravel-responsecache/pull/437
• @kra-so made their first contribution in https://github.com/spatie/laravel-responsecache/pull/451

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

What's Changed

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

New Contributors

• @Fot0n made their first contribution in https://github.com/spatie/laravel-responsecache/pull/428
• @dorqa95 made their first contribution in https://github.com/spatie/laravel-responsecache/pull/431
• @swichers made their first contribution in https://github.com/spatie/laravel-responsecache/pull/434

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

• add support for L10

What's Changed

• Bump stefanzweifel/git-auto-commit-action from 4.15.4 to 4.16.0 by @dependabot in https://github.com/spatie/laravel-responsecache/pull/424
• Normalize query string parameters before hashing by @cosmastech in https://github.com/spatie/laravel-responsecache/pull/426

New Contributors

• @cosmastech made their first contribution in https://github.com/spatie/laravel-responsecache/pull/426

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

What's Changed

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

New Contributors

• @AyoobMH made their first contribution in https://github.com/spatie/laravel-responsecache/pull/418
• @dependabot made their first contribution in https://github.com/spatie/laravel-responsecache/pull/423
• @roberttolton made their first contribution in https://github.com/spatie/laravel-responsecache/pull/408

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

What's Changed

• Dispatch clear events when using facade by @mateusjunges in https://github.com/spatie/laravel-responsecache/pull/413

New Contributors

• @mateusjunges made their first contribution in https://github.com/spatie/laravel-responsecache/pull/413

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

What's Changed

• Always prepend app url to requests by @apeisa in https://github.com/spatie/laravel-responsecache/pull/409

New Contributors

• @apeisa made their first contribution in https://github.com/spatie/laravel-responsecache/pull/409

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

What's Changed

• Cache bypass header now also prevents an already cached response from being returned by @fgilio in https://github.com/spatie/laravel-responsecache/pull/407

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

What's Changed

• Add cache bypass header by @fgilio in https://github.com/spatie/laravel-responsecache/pull/406

New Contributors

• @fgilio made their first contribution in https://github.com/spatie/laravel-responsecache/pull/406

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

What's Changed

• Handle missed cache gracefully by @antennaio in https://github.com/spatie/laravel-responsecache/pull/383

New Contributors

• @antennaio made their first contribution in https://github.com/spatie/laravel-responsecache/pull/383

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

What's Changed

• Add option to output cache age header by @it-can in https://github.com/spatie/laravel-responsecache/pull/385

New Contributors

• @it-can made their first contribution in https://github.com/spatie/laravel-responsecache/pull/385

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

• support Laravel 9