Memcached в 1С-Битрикс

Memcached в 1С-Битрикс

Memcached — один из поддерживаемых бэкендов для кеширования и key-value хранения данных в 1С-Битрикс. Платформа использует PHP-расширение memcached (отличается от memcache — это два разных расширения PHP).

Классы для работы с Memcached

В модуле main определены следующие классы:

• \Bitrix\Main\Data\MemcachedConnection — класс подключения к Memcached (наследуется от NosqlConnection). Расположен в файле /bitrix/modules/main/lib/Data/MemcachedConnection.php.
• \Bitrix\Main\Data\CacheEngineMemcached — класс-движок кеширования для Memcached. Расположен в файле /bitrix/modules/main/lib/Data/CacheEngineMemcached.php.
• \Bitrix\Main\Data\Configurator\MemcachedConnectionConfigurator — конфигуратор подключения.

Методы класса MemcachedConnection

• __construct(...) — конструктор
• connectInternal() — внутреннее подключение к серверу
• disconnectInternal() — отключение
• get($key) — получение значения по ключу
• set($key, $value) — установка значения

Настройка подключения Memcached в .settings.php

Подключение настраивается в секции connections файла /bitrix/.settings.php:

'memcached' => [
    'className' => \Bitrix\Main\Data\MemcachedConnection::class,
    'host' => '127.0.0.1',
    'port' => 11211,
    'persistent' => true,
    'connectionTimeout' => 1000,
    'serializer' => \Memcached::SERIALIZER_PHP,
],

Параметры:

• host — хост сервера Memcached (по умолчанию localhost)
• port — порт (по умолчанию 11211)
• persistent — использовать постоянный идентификатор bx_cache (по умолчанию true)
• connectionTimeout — таймаут подключения в миллисекундах (по умолчанию 1000)
• serializer — сериализатор Memcached::OPT_SERIALIZER, например \Memcached::SERIALIZER_PHP

Кластер Memcached

Для подключения кластера вместо host и port укажите параметр servers — массив серверов:

'memcached.cluster' => [
    'className' => \Bitrix\Main\Data\MemcachedConnection::class,
    'servers' => [
        ['host' => '10.0.0.20', 'port' => 11211, 'weight' => 1],
        ['host' => '10.0.0.21', 'port' => 11211, 'weight' => 1],
    ],
    'persistent' => true,
    'connectionTimeout' => 1000,
    'serializer' => \Memcached::SERIALIZER_PHP,
],

Каждый элемент массива servers может содержать параметры host, port и weight (вес, по умолчанию 1). Чем больше weight, тем больше запросов получает сервер.

Использование Memcached для кеширования

Memcached можно использовать как движок кеширования в секции cache файла .settings.php:

'cache' => [
    'value' => [
        'type' => [
            'class_name' => '\\Bitrix\\Main\\Data\\CacheEngineMemcached',
            'extension' => 'memcached',
        ],
        'memcached' => [
            'host' => '127.0.0.1',
            'port' => '11211',
        ],
        'sid' => $_SERVER['DOCUMENT_ROOT'] . '#01',
    ],
],

Методы CacheEngineMemcached

• getConnectionName() — имя подключения
• getConnectionClass() — класс подключения
• configure(array $config) — конфигурация движка
• set($key, $ttl, $value) — запись значения в кеш
• del($key) — удаление значения
• setNotExists($key, $ttl, $value) — запись если ключ не существует
• deleteBySet($key, $prefix) — удаление по набору

Отличие Memcache от Memcached

В 1С-Битрикс поддерживаются оба расширения PHP:

• Memcache — класс \Bitrix\Main\Data\MemcacheConnection, расширение PHP memcache, используется pconnect для постоянных соединений.
• Memcached — класс \Bitrix\Main\Data\MemcachedConnection, расширение PHP memcached (более современное и функциональное), поддерживает serializer и OPT_SERIALIZER.