shammaa/laravel-intelligent-cache

An intelligent response caching package for Laravel with automatic invalidation and smart headers.

v1.0.9 2026-01-12 15:18 UTC

Requires

• php: ^8.1
• illuminate/cache: ^10.0|^11.0
• illuminate/http: ^10.0|^11.0
• illuminate/support: ^10.0|^11.0

MIT

• Shammaa

README

Laravel Intelligent Cache is a high-performance, context-aware response caching package. It is designed to significantly boost your application's speed and optimize SEO by intelligently managing Cache-Control headers and providing automatic cache invalidation.

🌟 Main Objectives

1. Boost Speed: Achieve near-zero TTFB (Time to First Byte) by caching full HTML responses.
2. Improve SEO: Automatically fix the no-cache issue that hurts Google rankings by providing proper caching headers.
3. Always Fresh: Keep content updated automatically. When you add a new article, the cache refreshes itself.

🛠 Installation

You can install the package via composer:

composer require shammaa/laravel-intelligent-cache

Publish Config

php artisan vendor:publish --provider="Shammaa\IntelligentCache\IntelligentCacheServiceProvider"

🚀 How to Use

1. The "Smart" Part (Auto-Update)

Add the HasSmartCache trait to any Model (like Article.php). This will automatically clear the cache whenever a new item is added or updated.

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Shammaa\IntelligentCache\Traits\HasSmartCache;

class Article extends Model
{
    use HasSmartCache;
}

2. Speed Up Your Pages

Option A: Global Registration (Recommended)

To solve the no-cache issue site-wide, you must register the middleware at the beginning of the stack (Outermost). This ensures it overrides any headers set by other middlewares (like Session).

Laravel 11 (bootstrap/app.php):

->withMiddleware(function (Middleware $middleware) {
    $middleware->web(prepend: [ // Use PREPEND here
        \Shammaa\IntelligentCache\Http\Middleware\CacheResponse::class,
    ]);
})

Laravel 10 & 9 (app/Http/Kernel.php): Add it at the TOP of your web middleware group:

protected $middlewareGroups = [
    'web' => [
        \Shammaa\IntelligentCache\Http\Middleware\CacheResponse::class, // Put it at the top
        // ... other middlewares
    ],
];

Option B: Route Specific

Alternatively, apply it to specific routes using the automatically registered alias smart_cache:

Route::middleware(['smart_cache'])->group(function () {
    Route::get('/articles', [ArticleController::class, 'index']);
});

⚙️ Configuration

You can find the settings in config/intelligent-cache.php:

• lifetime: How long to keep the cache (in seconds).
• exclude: URL patterns that should never be cached (like /admin/*).
• headers: Custom cache rules for browsers and Google.

📈 Performance Impact

• LCP (Largest Contentful Paint): Faster server responses lead to better user experience scores.
• TTFB (Time to First Byte): Eliminates database overhead for repeat visitors.

License

The MIT License (MIT). Created with ❤️ by Shammaa.