Сервисы · Пакет

Redis

winter-service-redis — готовый сервис Redis. Приложение поднимает его раньше всего остального, ждёт, пока он ответит, проверяет его, пока он работает, перезапускает после падения или зависания и останавливает последним — сохранив данные.

Пакет flytachi/winter-service-redisКласс RedisВерсия 8.8 (Alpine 3.24)

Что это и зачем

Что это. Класс Redis, реализующий Service: он знает, как запустить Redis в контейнере приложения, как понять, что он готов, как его остановить и что ему нужно в образе.

Проблема. Свой Redis в контейнере — это конфиг с паролем, который не должен попасть в командную строку, сокет вместо открытого порта, решение «хранить данные или это кеш», лимит памяти и проверка готовности, которая не пускает приложение, пока Redis ещё загружает данные с диска.

Решение. Всё это — в пакете и проверено на настоящем сервере. В проекте остаётся одна строка.

Пакет запускает сервер. Подключаются к нему как обычно — через winter-redis или phpredis, см. Подключение.

Установка

bash
composer require flytachi/winter-service-redis

Нужны PHP 8.4+, flytachi/winter-kernel 4.5+ и образ flytachi/winter (Alpine): сам сервер ставится из apk, и call service docker добавляет его в образ.

Быстрый старт

1. Объявить:

bootstrap.php
use Flytachi\Winter\Service\Redis\Redis;

protected static function components(Components $components): void
{
  $components->service(new Redis(maxmemory: '256mb'));
}

2. Добавить в образ:

bash
php call service docker

В Dockerfile появится apk add redis и каталоги с владельцем winter. Compose команда не трогает — она печатает, что в него добавить:

docker-compose.yml
services:
server:
  stop_grace_period: 70s
  volumes:
    - redis-data:/var/lib/redis
volumes:
redis-data:
  • stop_grace_period — нужен всегда: HTTP 30 с + Redis 30 с (на сохранение данных) + 5 + 5.
  • Том — если данные должны пережить пересоздание контейнера. Кешу (persist: false) не нужен ни том, ни каталог данных.
bash
docker compose up -d --build

3. Запустить. В логе:

text
[2026-11-15 16:12:37] [INFO ] -sys- [1]: Application starting High: redis
[2026-11-15 16:12:37] [INFO ] -redis- [11]: Server initialized
[2026-11-15 16:12:37] [INFO ] -redis- [11]: Ready to accept connections unix
[2026-11-15 16:12:37] [INFO ] -sys- [1]: redis is up.

Хранить данные или кеш

persist: true (по умолчанию) persist: false
Что на диске снимок RDB по расписанию Redis и при остановке ничего
После перезапуска данные на месте пусто
Том нужен не нужен
Для чего сессии, очереди, счётчики кеш, который можно потерять

aof: true добавляет журнал всех записей (appendonly yes): после падения теряется не всё с последнего снимка, а почти ничего. Работает только вместе с persist.

Без maxmemory у Redis нет предела

Без maxmemory Redis растёт, пока не кончится память контейнера, и тогда OOM-killer убивает всё приложение целиком: Redis живёт в его контейнере, а приложение — это PID 1. Задайте maxmemory меньше памяти контейнера, оставив место приложению. С политикой по умолчанию (noeviction) заполненный Redis отказывает в записи (OOM command not allowed), а приложение продолжает работать. Кешу, который может терять ключи, — политику вытеснения.

Обычная пара для кеша:

php
new Redis(persist: false, maxmemory: '256mb', maxmemoryPolicy: 'allkeys-lru');

Параметры

Сервер

Параметр По умолчанию Что задаёт
data /var/lib/redis Каталог данных, когда они хранятся, — его держат в томе
socket /run/redis Каталог Unix-сокета (redis.sock)
host null null — только сокет, снаружи контейнера не подключиться. 127.0.0.1 — ещё и TCP внутри контейнера. 0.0.0.0 — и для других контейнеров. С host нужен пароль
port 6379 Порт TCP
password null Спрашивается при каждом подключении — и через сокет тоже (requirepass)
persist true Хранить ли данные на диске — см. выше
aof false Ещё и журнал всех записей. Только с persist
maxmemory null Сколько памяти можно: 256mb, 1gb; null — без предела
maxmemoryPolicy null Что удалять, когда память кончилась: allkeys-lru, volatile-ttl…; null — как в Redis, noeviction (запись отклоняется)
settings [] Другие настройки, каждая уходит как --ключ значение: ['databases' => 4, 'timeout' => 300]; true/false становятся yes/no
args [] Другие аргументы redis-server как есть
logs true Писать ли лог Redis в лог приложения — см. Лог

Компонент

Параметр По умолчанию Что задаёт
name 'redis' Имя в логах и app status; том в подсказке compose — {name}-data
priority Priority::High Стартует раньше остальных, останавливается после них
critical true Не может работать — приложение останавливается
retries 3 Перезапуски после падения за 30 минут
grace 30.0 Секунды на остановку — на сохранение данных — до SIGKILL
startTimeout 60 Секунды, чтобы стать готовым
alive true true — PING раз в 10 с, 5 с на ответ, 6 неудач подряд значат «завис». Свой Probe. null или false — не проверять

Всё проверяется при создании объекта: относительный путь, порт вне диапазона, host без пароля, aof без persist, размер или политика, которых Redis не знает, настройка, которую сервис ставит сам (requirepass, port, dir…), значение в две строки — каждое даёт InvalidArgumentException с объяснением.

Что происходит при старте

Перед сервером работает скрипт пакета, который затем сам становится сервером (exec), поэтому сигнал остановки приходит прямо Redis:

  1. redis-server нет в образе → старт останавливается: «Add it to the image: call service docker».
  2. Конфиг — сокет, адрес и порт или их отсутствие, пароль, хранение, лимит памяти — подаётся серверу на стандартный вход, а не в командную строку. Пароль не виден ни в ps, ни на диске.

Готовность. Redis готов, когда на PING через сокет пришёл ответ — но не LOADING: пока Redis загружает данные с диска, приложение его ждёт. С паролем PING без пароля получает NOAUTH, загрузились данные или нет, — тогда Redis считается готовым, как только ответил.

Без пароля Redis при старте пишет предупреждение, что принимает любого локального клиента. Через сокет внутри контейнера так и есть.

Подключение

php
$redis->socketPath();   // /run/redis/redis.sock

Через phpredis

php
$client = new \Redis();
$client->connect($redis->socketPath());
if ($redis->password !== null) {
  $client->auth($redis->password);
}

Через winter-redis

Естественное место — класс конфигурации Redis: один и тот же класс и запускает сервер, и подключается к нему.

main/Configs/MainRedisConfig.php
namespace Main\Configs;

use Flytachi\Winter\Redis\Config\RedisConfig;
use Flytachi\Winter\Redis\Pool\RedisPoolConfigInterface;
use Flytachi\Winter\Redis\Pool\RedisPoolTrait;
use Flytachi\Winter\Service\Redis\Redis;

class MainRedisConfig extends RedisConfig implements RedisPoolConfigInterface
{
  use RedisPoolTrait;

  public int $poolMaxConnections = 10;

  /** What the application runs. */
  public static function service(): Redis
  {
      return new Redis(maxmemory: '256mb');
  }

  /** How winter-redis connects to it. */
  public function setUp(): void
  {
      $redis = self::service();
      $this->host = $redis->socketPath();         // a socket path is a host for phpredis…
      $this->port = 0;                            // …when the port is not one
      $this->password = $redis->password ?? '';
  }
}
bootstrap.php
protected static function components(Components $components): void
{
  $components->service(MainRedisConfig::service());
}

Хранилище ссылается на неё:

php
class VisitStore extends RedisStore
{
  protected string $redisConfigClassName = MainRedisConfig::class;
  protected string $prefix = 'visits:';
}

$count = new VisitStore()->increment('total');

port = 0 обязателен: phpredis считает путь сокетом, только когда порт меньше 1. С портом winter-redis по умолчанию, 6379, он ищет путь как имя хоста и падает с DNS Lookup resolve failed.

Если Redis открыт по TCP (задан host), в setUp() хостом становится 127.0.0.1 — или имя контейнера, — а port берётся из сервиса.

Лог

Лог Redis идёт в лог приложения: в том же формате, канал -redis- (в цвете — синий), в скобках — PID процесса, который написал строку: самого сервера или дочернего, который сохраняет снимок.

text
[2026-11-15 16:13:05] [INFO ] -redis- [11]: Saving the final RDB snapshot before exiting.
[2026-11-15 16:13:05] [INFO ] -redis- [11]: DB saved on disk
Redis Лог
. debug, - verbose DEBUG
* notice INFO
# warning WARN
  • Последние слова Redis — Redis is now ready to exit, bye bye... — он пишет как предупреждение. Это удачная остановка, поэтому в лог они идут как INFO.
  • LOG_LEVEL действует и на Redis. Без LOG_LEVEL (лог выключен) не видно и его строк. Нужен вывод Redis без изменений — logs: false.

Остановка

SIGTERM: Redis сохраняет снимок (с persist), дописывает журнал (с aof) и выходит с кодом 0. Он останавливается последним, после HTTP, поэтому контейнеру нужен stop_grace_period: 70s: 30 секунд на HTTP, 30 на Redis и по 5 запаса.

Большой набор данных сохраняется дольше: поднимите grace и вместе с ним stop_grace_period. Иначе SIGKILL придёт посреди сохранения, и после старта будут данные прошлого снимка.

Дальше