Cache Types — Configuration, Block HTML, and Custom Caches

All Cache Types

php bin/magento cache:status

Cache Management

# Check status
php bin/magento cache:status

# Clean specific type
php bin/magento cache:clean config

# Flush all cache
php bin/magento cache:flush

# Disable specific type
php bin/magento cache:disable block_html

# Enable specific type
php bin/magento cache:enable block_html

What Configuration Cache Stores

• Module configuration (config.xml)
• System configuration (system.xml)
• di.xml compiled configuration
• Layout XML files
• Theme configuration

When Configuration Cache Clears

# After module install/upgrade
php bin/magento setup:upgrade

# After config change
php bin/magento app:config:import

# Manual clean
php bin/magento cache:clean config

Configuration Cache Impact

// Configuration loaded from cache in production
// Without cache: every request loads all XML files
// With cache: XML loaded once, served from cache

// Performance impact:
// Without config cache: +200-500ms per request
// With config cache: ~10ms

Clearing Strategy

# Production: only clear when needed
php bin/magento cache:clean config  # Only when config changes

# Development: clear more frequently
php bin/magento cache:flush  # Clear everything

What Block HTML Cache Stores

Rendered HTML output of blocks with cacheable=true.

// Block with caching
public class ProductList extends \Magento\Framework\View\Element\Template
{
    public function __construct(
        \Magento\Framework\View\Element\Template\Context $context,
        array $data = []
    ) {
        parent::__construct($context, $data);
    }
}

Cacheable Blocks

// Cacheable block (default)
public function getCacheKey()
{
    return 'product_list_' . $this->getCategory()->getId();
}

public function getCacheLifetime()
    return 3600; // 1 hour
}

Non-Cacheable Blocks

// Non-cacheable block
public function __construct(
    // ...
    array $data = []
) {
    $data['cacheable'] = false;
    parent::__construct($context, $data);
}

Block Cache Tags

public function getCacheTags()
{
    return ['catalog_product_' . $this->getProduct()->getId()];
}

Register Custom Cache Type

<!-- etc/cache.xml -->
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="urn:magento:framework:Cache/etc/cache.xsd">
    <type id="vendor_module_cache"
          translate="label"
          label="Vendor Module Cache"
          instance="Magento\Framework\Cache\Backend\Redis"/>
</config>

Using Custom Cache

namespace Vendor\Module\Service;

use Magento\Framework\Cache\CacheInterface;

class DataCache
{
    public function __construct(
        private CacheInterface $cache
    ) {}

    public function getData(string $key): ?string
    {
        $cacheKey = 'vendor_module_' . $key;
        $data = $this->cache->load($cacheKey);
        
        if ($data === false) {
            $data = $this->fetchData($key);
            $this->cache->save(serialize($data), $cacheKey, ['vendor_module'], 3600);
        }
        
        return unserialize($data);
    }

    public function cleanCache(): void
    {
        $this->cache->clean('tags', ['vendor_module']);
    }
}

Cache Configuration in config.php

// app/etc/config.php
'cache_types' => [
    'config' => 1,
    'layout' => 1,
    'block_html' => 1,
    'collections' => 1,
    'vendor_module_cache' => 1
]