Сессии Bitrix: как выбрать оптимальный способ хранения

Примеры настройки и реализации

Пример 1: Полная настройка Redis через .settings.php с дополнительными параметрами

'sessions' => [
    'value' => [
        'type'      => 'redis',
        'host'      => '192.168.1.50',
        'port'      => 6380,
        'prefix'    => 'SITE1_SESS_',
        'password'  => 'secret',
        'database'  => 0,
        'life_time' => 7200,
        'timeout'   => 1.5,
    ],
],

Пояснение: Параметр password используется, если Redis защищён паролем. database позволяет выбрать номер базы данных Redis (0-15). timeout задаёт таймаут соединения в секундах. После добавления этой конфигурации нужно перезапустить веб-сервер или сбросить кеш Битрикса.

[Результат] Все новые сессии сохраняются в Redis на указанном сервере. Время жизни каждой сессии - 2 часа.

Пример 2: Использование Bitrix\Main\Session\SessionHandler для ручного управления сессией в компоненте

\Bitrix\Main\Loader::includeModule('main');

$handler = \Bitrix\Main\Session\SessionHandler::getInstance();
$handler->setSessionId('custom_sid');
$handler->start();

$_SESSION['my_data'] = ['user_id' => 123, 'time' => time()];

// Принудительная запись и закрытие
$handler->write('custom_sid', session_encode());
$handler->close();

Пояснение: В данном примере сессия стартует с заданным идентификатором. Это может быть полезно при реализации собственного механизма аутентификации. Обратите внимание, что прямое использование session_set_save_handler в Битриксе не допускается - используйте только методы SessionHandler.

[Результат] В хранилище будет создана сессия с ID 'custom_sid' и данными.

Пример 3: Создание сессии в REST-контроллере без использования cookie

\Bitrix\Main\Session\SessionHandler::getInstance()->setSessionId($httpRequest->get('session_id'));
if (!\Bitrix\Main\Session\SessionHandler::getInstance()->start()) {
    // сессия не найдена или повреждена
    $response = ['error' => 'Session expired'];
} else {
    $data = $_SESSION['api_data'] ?? [];
    $response = ['success' => true, 'data' => $data];
}

Пояснение: Для REST API часто требуется передавать идентификатор сессии в параметрах запроса (например, ?session_id=xxx). Здесь сессия стартует с указанным ID без опоры на cookie.

[Результат] Если сессия существует, данные из неё возвращаются в ответе; иначе - ошибка.

Пример 4: Переопределение обработчика сессий для записи в ClickHouse (нестандартное хранилище)

class ClickHouseSessionHandler implements \SessionHandlerInterface
{
    private $conn;
    private $table = 'sessions';

    public function open($savePath, $sessionName): bool
    {
        // Подключение к ClickHouse через TCP
        $this->conn = new \ClickHouseDB\Client(['host' => 'localhost', 'port' => '8123']);
        return true;
    }

    public function read($sessionId): string
    {
        $result = $this->conn->select("SELECT data FROM {$this->table} WHERE id = ?", [$sessionId]);
        $row = $result->fetchOne();
        return $row ? $row['data'] : '';
    }

    public function write($sessionId, $data): bool
    {
        $this->conn->insert($this->table, [
            ['id' => $sessionId, 'data' => $data, 'expire' => time() + 3600]
        ]);
        return true;
    }

    public function destroy($sessionId): bool
    {
        $this->conn->delete($this->table, "id = ?", [$sessionId]);
        return true;
    }

    public function gc($maxlifetime): int|false
    {
        $this->conn->delete($this->table, "expire < ?", [time()]);
        return true;
    }

    public function close(): bool { return true; }
}

// Инициализация в init.php
\Bitrix\Main\Session\SessionHandler::setHandler(new ClickHouseSessionHandler());

Пояснение: ClickHouse не предназначен для высокочастотных операций записи, но данный пример демонстрирует, как можно адаптировать хранилище сессий под специфические требования (например, долгосрочный аудит).

[Результат] Сессии сохраняются в таблице sessions ClickHouse. Чтение и запись работают через HTTP-интерфейс.