Кэширование в 1С-Битрикс — управляемый и тегированный кэш

<?php
$APPLICATION->IncludeComponent(
    "bitrix:news.list",
    "catalog",
    [
        "IBLOCK_ID" => 2,
        "CACHE_TYPE" => "A",      // A = автоматический
        "CACHE_TIME" => 3600,     // 1 час
        "CACHE_GROUPS" => "N",    // Не разделять по группам пользователей
    ]
);

1. Компонент генерирует HTML
2. Сохраняет в /bitrix/cache/ с метками (теги инфоблока)
3. При изменении элемента инфоблока — сброс всех кэшей с этим тегом

<?php
use Bitrix\Main\Data\Cache;
use Bitrix\Main\Application;

$cache = Cache::createInstance();
$cacheTime = 3600; // 1 час
$cacheId = 'product_list_' . md5(serialize($filter));
$cacheDir = '/my_cache/products/';

if ($cache->initCache($cacheTime, $cacheId, $cacheDir)) {
    // Данные в кэше
    $products = $cache->getVars()['products'];
} elseif ($cache->startDataCache()) {
    // Генерируем данные
    $products = getProductsFromDatabase($filter);

    // Добавляем теги для автосброса
    $taggedCache = Application::getInstance()->getTaggedCache();
    $taggedCache->startTagCache($cacheDir);
    $taggedCache->registerTag('iblock_id_2'); // При изменении инфоблока 2
    $taggedCache->registerTag('catalog_products'); // Кастомный тег
    $taggedCache->endTagCache();

    // Сохраняем в кэш
    $cache->endDataCache(['products' => $products]);
}

<?php
use Bitrix\Main\Application;

$taggedCache = Application::getInstance()->getTaggedCache();

// Сбросить всё с тегом catalog_products
$taggedCache->clearByTag('catalog_products');

// Сбросить кэш конкретного инфоблока
$taggedCache->clearByTag('iblock_id_2');

// Сбросить всё
\BXClearCache(true);

<?php
namespace Local\Catalog;

use Bitrix\Main\Data\Cache;
use Bitrix\Main\Application;
use Bitrix\Iblock\ElementTable;

class CachedProductRepository
{
    private const CACHE_DIR = '/local/products/';
    private const CACHE_TIME = 3600;
    private const IBLOCK_ID = 2;

    public function getList(array $filter = [], int $limit = 20): array
    {
        $cache = Cache::createInstance();
        $cacheId = $this->buildCacheId($filter, $limit);
        if ($cache->initCache(self::CACHE_TIME, $cacheId, self::CACHE_DIR)) {
            // ?? [] — страховка: кэш мог быть записан кодом предыдущей версии,
            // где набор ключей отличался, и тогда 'items' в нём не окажется
            return $cache->getVars()['items'] ?? [];
        }
        if ($cache->startDataCache()) {
            $items = $this->fetchFromDatabase($filter, $limit);
            // Регистрируем теги
            $this->registerCacheTags();
            $cache->endDataCache(['items' => $items]);
            return $items;
        }

        return [];
    }

    public function getById(int $id): ?array
    {
        $cache = Cache::createInstance();
        $cacheId = 'product_' . $id;
        if ($cache->initCache(self::CACHE_TIME, $cacheId, self::CACHE_DIR)) {
            return $cache->getVars()['item'];
        }
        if ($cache->startDataCache()) {
            $item = $this->fetchOneFromDatabase($id);
            $taggedCache = Application::getInstance()->getTaggedCache();
            $taggedCache->startTagCache(self::CACHE_DIR);
            $taggedCache->registerTag('iblock_id_' . self::IBLOCK_ID);
            $taggedCache->registerTag('product_' . $id); // Тег конкретного товара
            $taggedCache->endTagCache();
            $cache->endDataCache(['item' => $item]);
            return $item;
        }

        return null;
    }

    /**
     * Сброс кэша конкретного товара
     */
    public function clearProductCache(int $productId): void
    {
        $taggedCache = Application::getInstance()->getTaggedCache();
        $taggedCache->clearByTag('product_' . $productId);
    }

    /**
     * Сброс всего кэша каталога
     */
    public function clearAllCache(): void
    {
        $taggedCache = Application::getInstance()->getTaggedCache();
        $taggedCache->clearByTag('iblock_id_' . self::IBLOCK_ID);
    }

    private function buildCacheId(array $filter, int $limit): string
    {
        return 'list_' . md5(serialize($filter) . '_' . $limit);
    }

    private function registerCacheTags(): void
    {
        $taggedCache = Application::getInstance()->getTaggedCache();
        $taggedCache->startTagCache(self::CACHE_DIR);
        $taggedCache->registerTag('iblock_id_' . self::IBLOCK_ID);
        $taggedCache->endTagCache();
    }

    private function fetchFromDatabase(array $filter, int $limit): array
    {
        // Реальный запрос к БД
        return [];
    }

    private function fetchOneFromDatabase(int $id): ?array
    {
        return null;
    }
}

<?php
// /bitrix/php_interface/init.php
use Bitrix\Main\EventManager;
use Bitrix\Main\Application;

$eventManager = EventManager::getInstance();

// При изменении элемента инфоблока
$eventManager->addEventHandler('iblock', 'OnAfterIBlockElementUpdate', function ($arFields) {
    $taggedCache = Application::getInstance()->getTaggedCache();

    // Сбрасываем кэш конкретного элемента
    $taggedCache->clearByTag('product_' . $arFields['ID']);

    // В событиях обновления приходят только изменённые поля,
    // поэтому проверяем наличие ключа, а не его значение
    if (isset($arFields['ACTIVE'])) {
        $taggedCache->clearByTag('iblock_id_' . $arFields['IBLOCK_ID']);
    }
});

// При добавлении/удалении элемента
$eventManager->addEventHandler('iblock', 'OnAfterIBlockElementAdd', function ($arFields) {
    $taggedCache = Application::getInstance()->getTaggedCache();
    $taggedCache->clearByTag('iblock_id_' . $arFields['IBLOCK_ID']);
});

$eventManager->addEventHandler('iblock', 'OnAfterIBlockElementDelete', function ($arFields) {
    $taggedCache = Application::getInstance()->getTaggedCache();
    $taggedCache->clearByTag('iblock_id_' . $arFields['IBLOCK_ID']);
    $taggedCache->clearByTag('product_' . $arFields['ID']);
});

<?php
// /bitrix/.settings_extra.php
return [
    'cache' => [
        'value' => [
            'type' => [
                'class_name' => '\\Bitrix\\Main\\Data\\CacheEngineRedis',
                'extension' => 'redis',
            ],
            'redis' => [
                'host' => '127.0.0.1',
                'port' => 6379,
            ],
            'sid' => $_SERVER['DOCUMENT_ROOT'] . '#01',
        ],
    ],
];

<?php
// /bitrix/.settings_extra.php
return [
    'cache' => [
        'value' => [
            'type' => [
                'class_name' => '\\Bitrix\\Main\\Data\\CacheEngineMemcache',
                'extension' => 'memcache',
            ],
            'memcache' => [
                'host' => '127.0.0.1',
                'port' => 11211,
            ],
            'sid' => $_SERVER['DOCUMENT_ROOT'] . '#01',
        ],
    ],
];

<?php
// Отладка тегов
$taggedCache = Application::getInstance()->getTaggedCache();

// Логируем все сбросы
file_put_contents(
    $_SERVER['DOCUMENT_ROOT'] . '/cache_debug.log',
    date('Y-m-d H:i:s') . " Clearing tag: {$tag}\n",
    FILE_APPEND
);

<?php
// Проверка работы кэша
$cache = Cache::createInstance();
if ($cache->initCache(60, 'test_cache', '/test/')) {
    echo 'FROM CACHE: ' . $cache->getVars()['time'];
} elseif ($cache->startDataCache()) {
    $time = time();
    $cache->endDataCache(['time' => $time]);
    echo 'GENERATED: ' . $time;
}

// Если при обновлении время не меняется — кэш работает