Magento Cacheمن الصفر.

'cache' => [
    'frontend' => [
        // الكاش العام (config, layout, block_html...)
        'default' => [
            'backend' => 'Cm_Cache_Backend_Redis',
            'backend_options' => [
                'server'   => '127.0.0.1',
                'port'     => '6379',
                // رقم قاعدة بيانات مستقل
                'database' => '0',
            ],
        ],
        // كاش الصفحات — قاعدة بيانات منفصلة
        'page_cache' => [
            'backend' => 'Cm_Cache_Backend_Redis',
            'backend_options' => [
                'server'   => '127.0.0.1',
                'port'     => '6379',
                'database' => '1',
            ],
        ],
    ],
],

# بيولّد ملف VCL مناسب لنسختك
bin/magento varnish:vcl:generate \
  --export-version=6 \
  --backend-host=localhost \
  --backend-port=8080 \
  --output-file=/etc/varnish/default.vcl

curl -I https://your-store.com/some-category

# دوّر على السطور دي في الرد:
#   X-Magento-Cache-Debug: HIT   ← الصفحة من الكاش ✓
#   X-Magento-Cache-Debug: MISS  ← اتبنت دلوقتي
#   Age: 320                     ← قاعدة في الكاش 320 ثانية

define(['Magento_Customer/js/customer-data'], function (customerData) {
    'use strict';

    // بيرجّع كائن قابل للمراقبة
    var cart = customerData.get('cart');
    var customer = customerData.get('customer');

    // بيتحدّث تلقائياً لما البيانات تتغيّر
    console.log(cart().summary_count);
    console.log(customer().firstname);
});

<?xml version="1.0"?>
<config>
  <!-- لما الـ action دي تتنفّذ، حدّث القسم -->
  <action name="vendor/loyalty/redeem">
    <section name="loyalty-points"/>
  </action>
</config>

namespace Vendor\Module\CustomerData;

use Magento\Customer\CustomerData\SectionSourceInterface;

class LoyaltyPoints implements SectionSourceInterface
{
    public function __construct(
        private readonly Session $customerSession,
        private readonly PointsRepository $points
    ) {}

    // بيرجّع البيانات اللي هتوصل للـ JS
    public function getSectionData(): array
    {
        if (!$this->customerSession->isLoggedIn()) {
            return ['points' => 0];
        }

        $customerId = $this->customerSession->getCustomerId();

        return [
            'points' => $this->points->getBalance($customerId),
        ];
    }
}

<type name="Magento\Customer\CustomerData\SectionPoolInterface">
  <arguments>
    <argument name="sectionSourceMap" xsi:type="array">
      <item name="loyalty-points" xsi:type="string">
        Vendor\Module\CustomerData\LoyaltyPoints
      </item>
    </argument>
  </arguments>
</type>

# صفحة منتج رقم 42 ممكن يكون عليها:
cat_p_42          # المنتج نفسه
cat_c_15          # القسم اللي فيه
cat_p             # كل المنتجات (عام)

# لما المنتج 42 يتغيّر، Magento بيمسح
# كل حاجة عليها cat_p_42 — ودي الصفحات
# اللي المنتج ده ظاهر فيها بس

class FeaturedProducts extends Template
    implements IdentityInterface
{
    // Magento بينده دي عشان يعرف الصفحة دي
    // تتمسح امتى
    public function getIdentities(): array
    {
        $identities = [];

        foreach ($this->getProducts() as $product) {
            // كل منتج بيضيف لافتته
            $identities = array_merge(
                $identities,
                $product->getIdentities()
            );
        }

        return $identities;
    }
}

<!-- block عادي — بيتكاش -->
<block class="Vendor\Module\Block\Info"
  name="my.info"
  template="Vendor_Module::info.phtml"/>

<!-- block مش بيتكاش -->
<block class="Vendor\Module\Block\Live"
  name="my.live"
  cacheable="false"/>

class MyBlock extends Template
{
    protected function _construct()
    {
        // مدة الكاش بالثواني (ساعة)
        $this->addData([
            'cache_lifetime' => 3600,
        ]);
    }

    // المفاتيح اللي بتميّز نسخ الـ block
    public function getCacheKeyInfo(): array
    {
        return [
            'MY_BLOCK',
            $this->_storeManager->getStore()->getId(),
            $this->getData('category_id'),
        ];
    }
}

namespace Vendor\Module\Model;

use Magento\Framework\App\CacheInterface;
use Magento\Framework\Serialize\SerializerInterface;

class ExpensiveData
{
    // مفتاح مميّز للبيانات دي
    private const CACHE_KEY = 'vendor_expensive_data';

    // لافتة عشان نقدر نمسحها انتقائياً
    private const CACHE_TAG = 'vendor_expensive';

    // المدة بالثواني — ساعة
    private const LIFETIME = 3600;

    public function __construct(
        private readonly CacheInterface $cache,
        private readonly SerializerInterface $serializer,
        private readonly ApiClient $api
    ) {}

    public function getData(): array
    {
        // 1. جرّب الكاش الأول
        $cached = $this->cache->load(self::CACHE_KEY);

        if ($cached) {
            // لقيناها — رجّعها بعد فك التحويل
            return $this->serializer->unserialize($cached);
        }

        // 2. مش موجودة — احسبها
        $data = $this->api->fetchSomethingSlow();

        // 3. خزّنها للمرة الجاية
        $this->cache->save(
            $this->serializer->serialize($data),
            self::CACHE_KEY,
            [self::CACHE_TAG],   // اللافتات
            self::LIFETIME        // المدة
        );

        return $data;
    }

    // لمسح الكاش ده تحديداً
    public function invalidate(): void
    {
        $this->cache->clean([self::CACHE_TAG]);
    }
}

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <type name="vendor_catalog_feed"
    translate="label,description"
    instance="Vendor\Module\Model\Cache\Type\Feed">
    <label>Catalog Feed</label>
    <description>Cached product feed data</description>
  </type>
</config>

namespace Vendor\Module\Model\Cache\Type;

use Magento\Framework\Cache\Frontend\Decorator\TagScope;
use Magento\Framework\App\Cache\Type\FrontendPool;

class Feed extends TagScope
{
    // لازم يطابق الـ name في cache.xml
    public const TYPE_IDENTIFIER = 'vendor_catalog_feed';

    // اللافتة اللي كل إدخالات النوع ده هتاخدها
    public const CACHE_TAG = 'VENDOR_CATALOG_FEED';

    public function __construct(FrontendPool $cacheFrontendPool)
    {
        parent::__construct(
            $cacheFrontendPool->get(self::TYPE_IDENTIFIER),
            self::CACHE_TAG
        );
    }
}

use Vendor\Module\Model\Cache\Type\Feed;

class FeedGenerator
{
    public function __construct(
        // بتحقن النوع بتاعك مباشرة
        private readonly Feed $cache
    ) {}

    public function get(string $key): ?string
    {
        $value = $this->cache->load($key);
        return $value !== false ? $value : null;
    }

    public function set(string $key, string $data): void
    {
        // اللافتة بتتضاف تلقائياً
        $this->cache->save($data, $key, [], 3600);
    }
}

bin/magento setup:upgrade
bin/magento cache:enable vendor_catalog_feed

# دلوقتي بيظهر في قائمة الأنواع
bin/magento cache:status

# ومسحه لوحده ممكن
bin/magento cache:clean vendor_catalog_feed

# شوف حالة كل الأنواع
bin/magento cache:status

# امسح الإدخالات القديمة (الأخف)
bin/magento cache:clean

# امسح نوع محدد — الأفضل في production
bin/magento cache:clean config layout block_html

# امسح كل حاجة بما فيها إدخالات تطبيقات تانية
bin/magento cache:flush

# عطّل نوع (للتطوير)
bin/magento cache:disable block_html

# فعّل تاني
bin/magento cache:enable block_html

# هل الصفحة بتتكاش؟
curl -I https://store.com/page | grep -i "x-magento-cache"

# حجم الكاش في Redis
redis-cli -n 0 INFO keyspace
redis-cli -n 1 INFO keyspace

# دوّر على blocks معطّلة للكاش (السبب الشائع)
grep -rn 'cacheable="false"' app/code/ vendor/ \
  --include="*.xml"

# عطّل الأنواع اللي بتعطّلك أثناء التطوير
bin/magento cache:disable block_html full_page layout

# سيبهم مفعّلين — مسحهم مكلّف وبطيء
#   config, db_ddl, compiled_config