use SmartCache\Facades\SmartCache; // Works exactly like Laravel Cache SmartCache::put('users', $users, 3600); $users = SmartCache::get('users'); // Remember pattern $users = SmartCache::remember('users', 3600, function() { return User::all(); });

// Store smart_cache(['products' => $products], 3600); // Retrieve $products = smart_cache('products');

// Large API response - automatically compressed $apiData = Http::get('api.example.com/large-dataset')->json(); SmartCache::put('api_data', $apiData, 3600); // Automatically compressed with gzip, saving up to 70% space

// 10,000+ records - automatically chunked $users = User::with('profile', 'posts')->get(); SmartCache::put('all_users', $users, 3600); // Automatically split into 1000-item chunks

$lock = SmartCache::lock('expensive_operation', 10); if ($lock->get()) { // Only one process executes this $data = expensiveApiCall(); SmartCache::put('api_data', $data, 3600); $lock->release(); } // Or use callback pattern SmartCache::lock('regenerate_cache', 30)->get(function() { return regenerateExpensiveData(); });

$memo = SmartCache::memo(); // First call hits cache, subsequent calls are instant $users = $memo->remember('users', 3600, fn() => User::all()); $users = $memo->get('users'); // Instant! (from memory) $users = $memo->get('users'); // Still instant! // Perfect for loops foreach ($products as $product) { $category = $memo->get("category_{$product->category_id}"); }

// Retrieve multiple keys $values = SmartCache::many(['key1', 'key2', 'key3']); // Store multiple keys SmartCache::putMany([ 'key1' => 'value1', 'key2' => 'value2', ], 3600); // Delete multiple keys SmartCache::deleteMultiple(['key1', 'key2', 'key3']);

// Enable in config config(['smart-cache.strategies.compression.mode' => 'adaptive']); // Automatically selects optimal level: SmartCache::put('hot_data', $frequentlyAccessed, 3600); // Level 3-4 (faster) SmartCache::put('cold_data', $rarelyAccessed, 3600); // Level 7-9 (smaller)

// Enable in config config(['smart-cache.strategies.chunking.lazy_loading' => true]); // Returns LazyChunkedCollection $largeDataset = SmartCache::get('100k_records'); // Chunks loaded on-demand (max 3 in memory) foreach ($largeDataset as $record) { processRecord($record); } // Access specific items $item = $largeDataset[50000]; // Only loads needed chunk

// Automatically chooses: SmartCache::put('simple', ['key' => 'value'], 3600); // JSON (fastest) SmartCache::put('complex', $objectGraph, 3600); // igbinary/PHP

// Enable in config config(['smart-cache.events.enabled' => true]); // Listen to events Event::listen(CacheHit::class, fn($e) => Log::info("Hit: {$e->key}")); Event::listen(CacheMissed::class, fn($e) => Log::warning("Miss: {$e->key}")); Event::listen(OptimizationApplied::class, fn($e) => Log::info("Optimized {$e->key}: {$e->ratio}% reduction") );

$apiData = SmartCache::swr('github_repos', function() { return Http::get('https://api.github.com/user/repos')->json(); }, 300, 900); // 5min fresh, 15min stale

$siteConfig = SmartCache::stale('site_config', function() { return Config::fromDatabase(); }, 3600, 86400); // 1hour fresh, 24hour stale

$analytics = SmartCache::refreshAhead('daily_analytics', function() { return Analytics::generateReport(); }, 1800, 300); // 30min TTL, 5min refresh window

// Clear by pattern SmartCache::flushPatterns([ 'user_*', // All user keys 'api_v2_*', // All API v2 cache '/product_\d+/' // Regex: product_123, product_456 ]); // Dependency tracking SmartCache::dependsOn('user_posts', 'user_profile'); SmartCache::invalidate('user_profile'); // Also clears user_posts

$metrics = SmartCache::getPerformanceMetrics(); // Returns: hit_ratio, compression_savings, operation_timing, etc. $analysis = SmartCache::analyzePerformance(); // Returns: health score, recommendations, issues

$status = SmartCache::executeCommand('status'); $clearResult = SmartCache::executeCommand('clear', ['key' => 'api_data']);

// config/smart-cache.php return [ // Size thresholds for optimization 'thresholds' => [ 'compression' => 1024 * 50, // 50KB - compress data larger than this 'chunking' => 1024 * 100, // 100KB - chunk arrays larger than this ], // Optimization strategies 'strategies' => [ 'compression' => [ 'enabled' => true, 'mode' => 'fixed', // 'fixed' or 'adaptive' 'level' => 6, // 1-9 (higher = better compression) ], 'chunking' => [ 'enabled' => true, 'chunk_size' => 1000, // Items per chunk 'lazy_loading' => false, // Enable for memory savings 'smart_sizing' => false, // Auto-calculate chunk size ], ], // Events (disabled by default for performance) 'events' => [ 'enabled' => false, ], // Performance monitoring 'monitoring' => [ 'enabled' => true, 'metrics_ttl' => 3600, ], ];

// Before (Laravel Cache) use Illuminate\Support\Facades\Cache; Cache::put('users', $users, 3600); $users = Cache::get('users'); // After (SmartCache) - just change the import use SmartCache\Facades\SmartCache; SmartCache::put('users', $users, 3600); // Now automatically optimized! $users = SmartCache::get('users'); // Automatically restored!