Download the PHP package iazaran/smart-cache without Composer

Laravel SmartCache - Intelligent Caching Optimization Package

Laravel SmartCache is a powerful caching optimization package designed to enhance the way your Laravel application handles data caching. It intelligently manages large data sets by compressing, chunking, or applying other optimization strategies to keep your application performant and efficient.

Perfect for Laravel developers looking to optimize cache performance, reduce memory usage, and improve application speed with intelligent data compression and cache management.

🚀 Features

• 🔍 Auto-detects large cache payloads - Automatically identifies when optimization is needed
• 📦 Compresses data before caching - Reduces storage requirements with gzip compression
• 🧩 Chunks large arrays or objects into manageable parts for better performance
• 🧠 Intelligent serialization - Advanced data serialization techniques
• ♻️ Seamless retrieval and reconstruction - Transparent data recovery
• ⚙️ Extensible strategy pattern for custom optimizations
• 🛡️ Optional fallback for incompatible drivers
• 🔄 Laravel-style helper function support
• 🎯 Redis and file cache driver optimization
• 📊 Performance monitoring and cache statistics

📦 Installation

Install the package via Composer:

Requirements: Laravel 8+ is supported. Tested with Redis and file cache drivers.

⚙️ Configuration

After installation, publish the config file:

The config file allows you to define thresholds, compression strategies, chunk sizes, and enabled features.

🧪 Usage

Basic Usage with SmartCache Facade

Use SmartCache just like Laravel's Cache facade:

Helper Function Usage

Or use the global helper function, similar to Laravel's cache() helper:

Dependency Injection

Or inject it into your services:

🔧 Optimization Strategies

SmartCache includes several cache optimization strategies that intelligently optimize your data:

🎯 Strategy Selection & Priority

SmartCache automatically selects the best optimization strategy for your data:

1. Chunking Strategy (Priority 1)

   • Applied to large arrays/collections with many items
   • Splits data into manageable chunks for better performance
   • Best for: Large datasets, API response arrays, database result sets

2. Compression Strategy (Priority 2)

   • Applied to large strings, arrays, and objects
   • Uses gzip compression to reduce cache size
   • Best for: Text data, serialized objects, repetitive content
3. No Optimization (Default)
   • Small data stays unchanged for optimal performance
   • No overhead for data that doesn't benefit from optimization

🧠 Intelligent Strategy Application

Each strategy evaluates the original data independently to determine if it should apply:

• Data Type Matching: Chunking only applies to arrays/collections, compression works on all types
• Size Thresholds: Each strategy has configurable size thresholds
• Driver Compatibility: Strategies respect cache driver limitations
• Performance Optimization: Only one strategy is applied per value (no chaining overhead)

🛠️ Built-in Strategies

• Compression: Uses gzip compression with configurable levels (1-9)
• Chunking: Splits large arrays into configurable chunk sizes
• Encoding: Safe serialization for different cache drivers
• Driver-Aware: Automatically adapts to your cache driver capabilities

⚙️ Extensible Architecture

Create custom strategies by implementing SmartCache\Contracts\OptimizationStrategy:

📂 Example: Large Dataset Caching

🎯 Strategy Selection Examples

🧰 Artisan Commands

SmartCache provides powerful Artisan commands for cache management and monitoring:

📊 Status Command

View SmartCache usage and configuration details:

What --force shows:

• ✅ Orphaned key detection - Find SmartCache-related keys that aren't properly tracked
• 🔍 Missing key validation - Identify managed keys that no longer exist in cache
• 🧹 Cache health insights - Get suggestions for cleanup and optimization

🗑️ Clear Command

Flexible cache clearing with precise control:

When to use --force:

• 🔧 Cleanup orphaned keys - Remove leftover SmartCache chunks or metadata
• 🎯 Clear non-managed keys - Remove regular Laravel cache keys when needed
• 🧹 Deep cleanup - Comprehensive cache maintenance and optimization

🎯 Use Cases

• Large API response caching - Optimize storage of external API data
• Database query result caching - Cache complex query results efficiently
• Session data optimization - Reduce session storage requirements
• File-based cache optimization - Improve file cache performance
• Redis memory optimization - Reduce Redis memory usage
• High-traffic applications - Improve performance under load

📊 Performance Benefits

• Up to 70% reduction in cache storage size
• Faster cache retrieval for large datasets
• Reduced memory usage in Redis and other drivers
• Improved application response times
• Better resource utilization

🔧 Supported Cache Drivers

• ✅ Redis - Full feature support with compression and chunking
• ✅ File Cache - Optimized file-based caching
• ✅ Database - Database cache driver optimization
• ✅ Array - In-memory cache optimization
• ⚠️ Memcached - Basic support (limited chunking)

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Reporting bugs
• Suggesting features
• Submitting pull requests
• Code style guidelines

📄 License

Laravel SmartCache is open-sourced software licensed under the MIT license.

🔗 Links

• GitHub Repository: https://github.com/iazaran/smart-cache
• Packagist Package: https://packagist.org/packages/iazaran/smart-cache
• Documentation: https://iazaran.github.io/smart-cache/

Built with ❤️ for developers who care about Laravel performance optimization and efficient caching strategies.

Keywords: Laravel caching, PHP cache optimization, Redis optimization, cache compression, Laravel performance, data chunking, cache management, Laravel package