Symfony/Cache في PHP: الدليل الكامل للتخزين المؤقت

في تطوير الويب الحديث، الأداء هو عامل حاسم. كل استعلام إضافي لقاعدة البيانات، كل إعادة حساب لنتيجة معقدة، هو إهدار للوقت وموارد الخادم. توفر مكتبة Symfony/Cache حلاً أنيقاً وقوياً لإدارة التخزين المؤقت في تطبيقات PHP. هي جزء من نظام Symfony البيئي، ولكن يمكن استخدامها بشكل مستقل تماماً في أي مشروع PHP، سواء كان Laravel أو Yii أو WordPress أو إطار عمل خاص بك.

المهمة الأساسية لـ Symfony/Cache هي تجريد العمل مع أنظمة تخزين مؤقت مختلفة (ملفات، Redis، Memcached، APCu، Doctrine DBAL وغيرها) من خلال واجهة موحدة وبسيطة وقابلة للتوقع (PSR-6 و PSR-16). هذا يعني أنه يمكنك كتابة الكود مرة واحدة، ثم تغيير نظام التخزين المؤقت الخلفي (مثلاً، الانتقال من الملفات إلى Redis) بمجرد تغيير الإعدادات، دون المساس بمنطق التطبيق. توفر المكتبة أيضاً أدوات قوية لإبطال التخزين المؤقت، ووسم السجلات، والحماية من "تدافع التخزين المؤقت" (cache stampede protection).

لماذا هذا مهم؟ التخزين المؤقت يسمح بتقليل زمن استجابة الخادم بعشرات بل مئات المرات. بدلاً من تنفيذ استعلام SQL ثقيل في كل مرة، أو تحليل HTML، أو الاتصال بـ API خارجي، تقوم بحفظ النتيجة في مخزن سريع (مثلاً في الذاكرة العشوائية) وتقديمها من التخزين المؤقت. Symfony/Cache تجعل هذه العملية آمنة، موحدة، ومريحة للمطور، مما يغنيك عن كتابة حلول مخصصة لكل نوع من أنواع التخزين.

التثبيت

يتم تثبيت المكتبة عبر Composer، مدير الحزم القياسي لـ PHP. نفّذ الأمر التالي في جذر مشروعك:

composer require symfony/cache

هذا الأمر سيقوم بتثبيت نواة المكتبة وجميع التبعيات الضرورية. إذا كنت تخطط لاستخدام محولات محددة (مثل Redis)، فستحتاج أيضاً إلى تثبيت إضافات PHP المناسبة (مثل ext-redis) وربما حزم إضافية:

# لـ Redis
composer require symfony/cache
# تأكد من تثبيت إضافة php-redis

# لـ Doctrine DBAL
composer require symfony/cache doctrine/dbal

# لاستخدام محول Chain (دمج عدة مخازن)
# لا حاجة لتثبيت أي شيء إضافي، فهو موجود بالفعل في النواة

بداية سريعة: مثال عملي بسيط

لنقم بإنشاء مثال بسيط لتخزين نتيجة عملية ثقيلة مؤقتاً. سنستخدم التخزين المؤقت بالملفات (FilesystemAdapter)، والذي لا يتطلب تثبيت خدمات إضافية ومناسب تماماً للتطوير والمشاريع الصغيرة.

<?php

require_once 'vendor/autoload.php';

use Symfony\Component\Cache\Adapter\FilesystemAdapter;

// 1. إنشاء المحول. سيتم تخزين الكاش في مجلد /var/cache/app
$cache = new FilesystemAdapter(
    $namespace = 'my_app', // مساحة الاسم لعزل الكاش
    $defaultLifetime = 3600, // مدة الحياة الافتراضية (ساعة واحدة)
    $directory = __DIR__ . '/var/cache' // مسار مجلد الكاش
);

// 2. محاولة الحصول على عنصر من الكاش باستخدام المفتاح 'heavy_computation_result'
$cacheKey = 'heavy_computation_result';
$cachedValue = $cache->getItem($cacheKey);

// 3. إذا لم يكن العنصر موجوداً في الكاش (cache miss) - نقوم بالعملية الثقيلة ونحفظ النتيجة
if (!$cachedValue->isHit()) {
    // محاكاة عملية ثقيلة (مثل استعلام معقد لقاعدة البيانات أو API خارجي)
    sleep(2);
    $result = 'نتيجة العمليات الثقيلة: ' . date('H:i:s');

    // حفظ النتيجة في الكاش
    $cachedValue->set($result);
    $cache->save($cachedValue);

    echo "تم حساب البيانات وحفظها في الكاش.<br>";
} else {
    echo "تم الحصول على البيانات من الكاش.<br>";
}

// 4. عرض النتيجة (من الكاش أو المحسوبة حديثاً)
echo $cachedValue->get();

عند