Memcached Laravel Package

Getting Started

Minimal Setup

1. Installation

   composer require besimple/memcached
   

   (Note: Due to lack of maintenance, verify compatibility with your Laravel version.)

2. Configuration Add to config/cache.php under stores:

   'memcached' => [
       'driver' => 'memcached',
       'host' => env('MEMCACHED_HOST', '127.0.0.1'),
       'port' => env('MEMCACHED_PORT', 11211),
       'prefix' => env('MEMCACHED_PREFIX', 'laravel_'),
       'options' => [
           'retry_interval' => 150,
           'timeout' => 2000,
       ],
   ],
   

3. First Use Case Cache a value with a 10-minute TTL:

   Cache::put('key', 'value', now()->addMinutes(10));
   $value = Cache::get('key'); // Retrieve
   

Implementation Patterns

Common Workflows

1. Cache-as-Sidecar Use alongside database queries to reduce load:

   $posts = Cache::remember('posts:latest', now()->addHours(1), function () {
       return Post::latest()->limit(10)->get();
   });
   

2. Tag-Based Invalidation (If supported; verify via Cache::tags())

   Cache::tags(['users', 'profile'])->put('user:1:profile', $profileData);
   Cache::tags(['users'])->flush(); // Invalidate all tagged keys
   

3. Fallback Logic

   $data = Cache::remember('expensive:data', now()->addDays(7), function () {
       return ExpensiveOperation::run();
   });
   

Integration Tips

• Queue Jobs: Cache job payloads to avoid reprocessing:

  Cache::put('job:payload:123', $payload, now()->addMinutes(5));
  

• API Responses: Cache API responses with Cache-Control headers:

  return Cache::remember('api:users', now()->addMinutes(5), function () {
      return Http::get('https://api.example.com/users');
  });
  

Gotchas and Tips

Pitfalls

1. No Maintenance

   • Risk: Unpatched vulnerabilities or breaking changes.
   • Mitigation: Fork the package or migrate to predis/predis or spatie/laravel-memcached if critical.

2. Connection Issues

   • Symptom: Silent failures or stale data.
   • Debug: Check memcached service status (sudo systemctl status memcached) and verify host/port in .env.

3. Prefix Collisions

   • Issue: Shared Memcached instances may conflict with other apps.
   • Fix: Use a unique prefix (e.g., laravel_app_).

Debugging

• Inspect Keys:

  $keys = Cache::getStore()->getConnection()->getKeys('laravel_*');
  

• Clear Cache:

  php artisan cache:clear
  

  (Note: May not work if the package lacks proper Laravel cache integration.)

Extension Points

• Custom Serialization: Override the serializer via the options array (if supported):

  'options' => [
      'serializer' => new \Memcached\Serializer\JsonSerializer(),
  ],
  

• Event Listeners: (Unlikely, but if hooks exist, bind to Cache::store events.)

Pro Tips

• Monitor Memory: Use memcached-tool to check memory usage:

  memcached-tool 127.0.0.1:11211 stats
  

• Fallback Cache: Combine with file driver for resilience:

  Cache::store('memcached')->remember(...);