Nosql: Руководство разработчика

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Nosql: Руководство разработчика». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

—
title: NoSQL
—

В рамках NoSQL-подхода Bitrix Framework поддерживает работу с key-value хранилищами:

• Redis — для кеширования, управления сессиями и обработки очередей задач,

• Memcached — только для кеширования данных.

Настройка Redis

1. Установите расширение Redis для PHP.

2. Откройте файл /bitrix/.settings.php.

3. Добавьте новое подключение в секцию connections:

'connections' => [
	'value' => [
		'default' => [
			'className' => \Bitrix\Main\DB\MysqliConnection::class,
			// настройки существующего подключения в БД
		],
		'custom.redis' => [
			'className' => \Bitrix\Main\Data\RedisConnection::class,
			'port' => 6379,
			'host' => '127.0.0.1',
			'serializer' => \Redis::SERIALIZER_IGBINARY,
		],
		'custom2.redis' => [
			'className' => \Bitrix\Main\Data\RedisConnection::class,
			'port' => 6379,
			'host' => '127.0.0.4',
			'serializer' => \Redis::SERIALIZER_IGBINARY,
		],
	],
	'readonly' => true,
]

Разные подключения Redis — custom.redis и custom2.redis — можно использовать для разных целей или распределения нагрузки.

Особенности Redis cluster

Redis поддерживает два подхода к организации кластера.

• Мультимастерная конфигурация — Multi-Master. Несколько серверов Redis работают как равноправные мастер-узлы и могут принимать запись. Каждый мастер-узел может иметь собственные реплики — слейвы.

• Традиционная конфигурация — Master-Slave. Все операции записи направляются на единственный мастер-узел. Слейвы будут копировать с него данные и обслуживать запросы на чтение.

Как настроить Redis cluster в режиме Multi-Master

1. Укажите все мастер-узлы в массиве servers.

2. Задайте параметры кластера.

// bitrix/.settings.php
return [
//...        
	'session' => [
		'value' => [
			'mode' => 'default',
			'handlers' => [
				'general' => [
					'type' => 'redis',   
					'servers' => [
						[
							'port' => 6379,
							'host' => '127.0.0.1',
						],
						[
							'port' => 6379,
							'host' => '127.0.0.2',
						],
						[
							'port' => 6379,
							'host' => '127.0.0.3',
						],
						'serializer' => \Redis::SERIALIZER_IGBINARY,
						'persistent' => false,
						'failover' => \RedisCluster::FAILOVER_DISTRIBUTE,
						'timeout' => null,
						'read_timeout' => null,
					],
				],           
			],
		]                   
	] 
];

• serializer — определяет формат хранения данных,

• persistent — управляет типом соединения,

• failover — определяет поведение при сбое,

• timeout — задает время ожидания соединения в секундах,

• read_timeout — задает время ожидания ответа после соединения в секундах.

Как настроить Redis cluster в режиме Master-Slave

1. Укажите основной сервер, который будет обрабатывать записи.

2. Redis обнаружит и задействует подключенные слейвы без дополнительных настроек.

return [
	'session' => [
		'value' => [
			'mode' => 'default',
			'handlers' => [
				'general' => [
					'type' => 'redis',
					'servers' => [
						[
							'port' => '30015',
							'host' => '127.0.0.1'
						],
					],
				],
			],
		],
	],
];з

Как получить и использовать соединение с Redis

Bitrix Framework предоставляет два способа взаимодействия с Redis:

/**
 * @var \Bitrix\Main\Data\RedisConnection $connection
 */
$connection = \Bitrix\Main\Application::getConnection('my-redis');
$connection->set('foo', 'bar');
$connection->get('foo');

/**
 * Можно получить объект подключения напрямую
 * 
 * @var \Redis
 */
$resource = $connection->getResource();
$resource->setnx('foo', 'bar');

Для большинства задач подходит RedisConnection— этот способ безопаснее и интегрирован с фреймворком. Прямой доступ к методам Redis через getResource() нужен только для специфичных операций, недоступных через стандартный API.

Настройка Memcached

1. Установите расширение Memcached для PHP.

2. Откройте файл /bitrix/.settings.php.

3. Добавьте новое подключение в секцию connections:

'connections' => [
	'value' => [
		'default' => [
			'className' => \Bitrix\Main\DB\MysqliConnection::class,
			//... настройки существующего подключения в БД
		],
		'custom.memcached' => [
			'className' => \Bitrix\Main\Data\MemcachedConnection::class,
			'port' => 11211,
			'host' => '127.0.0.1',
		],
      'custom2.memcached' => [
        'className' => \Bitrix\Main\Data\MemcachedConnection::class,
        'port' => 6379,
        'host' => '127.0.0.4',
		],
	],
	'readonly' => true,
]з

Особенности Memcached cluster

Чтобы распределить нагрузку между несколькими серверами Memcached, укажите их в параметре servers. Чем больше weight сервера, тем больше запросов он будет получать. Для равномерного распределения задайте одинаковые значения для всех серверов:

'connections' => [
	'value' => [
		'default' => [
			'className' => \Bitrix\Main\DB\MysqliConnection::class,
			//... настройки существующего подключения в БД
				],
		'custom.memcached' => [
			'className' => \Bitrix\Main\Data\MemcachedConnection::class,
			'servers' => [
				[
				'port' => 11211,
				'host' => '127.0.0.1',
				'weight' => 1,  
				],
				[
				'port' => 11211,
				'host' => '127.0.0.2',
				'weight' => 1, 
				],
			],
		],
	],
	'readonly' => true,
]з

Как получить и использовать соединение с Memcached

Bitrix Framework предлагает два подхода для работы с Memcached:

/**
 * @var \Bitrix\Main\Data\MemcachedConnection $connection
 */
$connection = \Bitrix\Main\Application::getConnection('custom.memcached');
$connection->set('foo', 'bar');
$connection->get('foo');

/**
 * Можно получить объект подключения напрямую
 * 
 * @var \Memcached
 */
$resource = $connection->getResource();
$resource->flush();

Для обычного кеширования используйте MemcachedConnection. Прямой доступ через getResource() позволяет использовать нативные методы Memcached и выполнять специфичные операции — такие как flush().