Использование кластера Yandex Managed Service for Valkey™ в качестве хранилища сессий PHP

Кластер Yandex Managed Service for Valkey™ можно использовать в качестве хранилища данных о сессиях PHP.

Чтобы настроить кластер Yandex Managed Service for Valkey™ в качестве хранилища сессий PHP:

1. Подготовьте инфраструктуру.
2. Выполните дополнительные настройки.
3. Настройте PHP для использования кластера Yandex Managed Service for Valkey™ в качестве хранилища сессий.
4. Проверьте сохранение данных сессий PHP в кластере Yandex Managed Service for Valkey™.

Если созданные ресурсы вам больше не нужны, удалите их.

Перед началом работыПеред началом работы

Необходимые платные ресурсыНеобходимые платные ресурсы

• Кластер-приемник Yandex Managed Service for Valkey™: использование выделенных хостам вычислительных ресурсов, объем хранилища и резервных копий (тарифы Valkey™).
• Публичные IP-адреса, если для хостов кластера включен публичный доступ (тарифы Virtual Private Cloud).
• Виртуальная машина: использование вычислительных ресурсов, хранилища, публичного IP-адреса и операционной системы (тарифы Compute Cloud).

Подготовьте инфраструктуруПодготовьте инфраструктуру

Выполните дополнительные настройкиВыполните дополнительные настройки

1. Подключитесь к ВМ с веб-сервером по SSH.

2. Установите сертификаты:

   sudo mkdir --parents /usr/local/share/ca-certificates/Yandex/ && \
   sudo wget "https://storage.yandexcloud.net/cloud-certs/RootCA.pem" \
       --output-document /usr/local/share/ca-certificates/Yandex/YandexInternalRootCA.crt
   

3. Подготовьте окружение и установите библиотеку phpredis с помощью pecl:

   sudo apt update && \
   sudo apt install php-dev pkg-php-tools redis-tools --yes && \
   sudo pecl channel-update pecl.php.net && \
   sudo pecl install redis
   

4. Станьте владельцем каталога /var/www/html/ и удалите из него все содержимое:

   sudo chown <имя_пользователя> /var/www/html/ --recursive && \
   rm /var/www/html/*
   

Настройте PHP для использования кластера Yandex Managed Service for Valkey™ в качестве хранилища сессийНастройте PHP для использования кластера Yandex Managed Service for Valkey™ в качестве хранилища сессий

1. Внесите изменения в конфигурационный файл php.ini для вашего веб-сервера.

   Обычно файл php.ini располагается в каталоге:

   • /etc/php/7.2/apache2/ для Apache;
   • /etc/php/7.2/fpm/ для NGINX.

   Уточнить расположение php.ini можно с помощью команды sudo find /etc/ -name php.ini.

   Примечание

   Не нужно вносить изменения в php.ini для PHP CLI.

   Нешардированный кластер

   Шардированный кластер

   [PHP]
   ...
   extension = redis
   ...
   [Session]
   session.save_handler = redis
   session.save_path = "tcp://<FQDN_хоста-мастера_Valkey™>:6379?auth=<пароль>"
   

   [PHP]
   ...
   extension = redis
   ...
   [Session]
   session.save_handler = rediscluster
   session.save_path = "seed[]=<FQDN1>:6379&seed[]=<FQDN2>:6379&seed[]=<FQDN3>:6379&auth=<пароль>"
   

   Где <FQDN1>, <FQDN2> и <FQDN3> — полные доменные имена хостов-мастеров кластера. Например, для кластера из 3-х шардов с паролем password значение параметра session.save_path будет выглядеть так:

   session.save_path = "seed[]=rc1a-t9h8gxqo********.mdb.yandexcloud.net:6379&seed[]=rc1b-7qxk0h3b********.mdb.yandexcloud.net:6379&seed[]=rc1c-spy1c1i4********.mdb.yandexcloud.net:6379&auth=password"
   

   Подробнее про подключение к кластеру смотрите в разделе Предварительная настройка для подключения к кластеру Valkey™.

2. Перезапустите веб-сервер:

   • sudo systemctl restart apache2 для Apache;
   • sudo systemctl restart php7.2-fpm для NGINX.

Проверьте сохранение данных сессий PHP в кластере Yandex Managed Service for Valkey™Проверьте сохранение данных сессий PHP в кластере Yandex Managed Service for Valkey™

1. Создайте в каталоге /var/www/html/ файл index.php, который будет выводить степени числа 2:

   <?php
   session_start();
   
   $count = isset($_SESSION['count']) ? $_SESSION['count'] : 1;
   
   echo $count;
   
   $_SESSION['count'] = $count * 2;
   

   При каждом обновлении страницы выводимое значение будет увеличиваться. Значение переменной $count будет сохраняться в данных сессии. Для каждой сессии в Valkey™ будет создан уникальный ключ.

2. Из ВМ подключитесь к кластеру Valkey™ с помощью redis-cli:

   redis-cli -c -h <FQDN_хоста-мастера> -a <пароль>
   

   Введите команду для просмотра хранящихся в Valkey™ ключей:

   KEYS *
   

   (empty list or set)
   

   Из результатов запроса видно, что сейчас в Valkey™ не хранится никаких данных.

3. Проверьте, сохраняются ли пользовательские сессии при подключении к веб-серверу:

   1. Введите в адресной строке браузера публичный IP-адрес ВМ с веб-сервером. При первом входе будет выведено число 1.
   2. Обновите страницу несколько раз: выводимое значение будет увеличиваться.
   3. Выполните вход на страницу из другого браузера — отсчет начнется с 1.
   4. Обновите страницу несколько раз: выводимое значение также будет увеличиваться.

   Сохранение значения переменной $count между обновлениями страницы браузера говорит о корректной работе настроенного механизма хранения сессий PHP в кластере Yandex Managed Service for Valkey™.

4. Повторите запрос на просмотр хранящихся в Valkey™ ключей:

   KEYS *
   

   1) "PHPREDIS_SESSION:keb02haicgi0ijeju3********"
   2) "PHPREDIS_SESSION:c5r0mbe1v84pn2b5kj********"
   

   Как видно из результатов запроса, для каждой сессии в Valkey™ создан свой ключ.

Удалите созданные ресурсыУдалите созданные ресурсы

Удалите ресурсы, которые вы больше не будете использовать, чтобы за них не списывалась плата: