Redis
winter-service-redis — готовый сервис Redis. Приложение поднимает его раньше всего
остального, ждёт, пока он ответит, проверяет его, пока он работает, перезапускает после
падения или зависания и останавливает последним — сохранив данные.
Что это и зачем
Что это. Класс Redis, реализующий Service:
он знает, как запустить Redis в контейнере приложения, как понять, что он готов, как его
остановить и что ему нужно в образе.
Проблема. Свой Redis в контейнере — это конфиг с паролем, который не должен попасть в командную строку, сокет вместо открытого порта, решение «хранить данные или это кеш», лимит памяти и проверка готовности, которая не пускает приложение, пока Redis ещё загружает данные с диска.
Решение. Всё это — в пакете и проверено на настоящем сервере. В проекте остаётся одна строка.
Пакет запускает сервер. Подключаются к нему как обычно — через winter-redis или
phpredis, см. Подключение.
Установка
composer require flytachi/winter-service-redisНужны PHP 8.4+, flytachi/winter-kernel 4.5+ и образ flytachi/winter (Alpine): сам
сервер ставится из apk, и call service docker добавляет его в образ.
Быстрый старт
1. Объявить:
use Flytachi\Winter\Service\Redis\Redis;
protected static function components(Components $components): void
{
$components->service(new Redis(maxmemory: '256mb'));
}2. Добавить в образ:
php call service dockerВ Dockerfile появится apk add redis и каталоги с владельцем winter. Compose команда
не трогает — она печатает, что в него добавить:
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) не нужен ни том, ни каталог данных.
docker compose up -d --build3. Запустить. В логе:
[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),
а приложение продолжает работать. Кешу, который может терять ключи, — политику вытеснения.
Обычная пара для кеша:
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:
redis-serverнет в образе → старт останавливается: «Add it to the image: call service docker».- Конфиг — сокет, адрес и порт или их отсутствие, пароль, хранение, лимит памяти —
подаётся серверу на стандартный вход, а не в командную строку. Пароль не виден ни в
ps, ни на диске.
Готовность. Redis готов, когда на PING через сокет пришёл ответ — но не LOADING:
пока Redis загружает данные с диска, приложение его ждёт. С паролем PING без пароля
получает NOAUTH, загрузились данные или нет, — тогда Redis считается готовым, как только
ответил.
Без пароля Redis при старте пишет предупреждение, что принимает любого локального клиента. Через сокет внутри контейнера так и есть.
Подключение
$redis->socketPath(); // /run/redis/redis.sockЧерез phpredis
$client = new \Redis();
$client->connect($redis->socketPath());
if ($redis->password !== null) {
$client->auth($redis->password);
}Через winter-redis
Естественное место — класс конфигурации Redis: один и тот же класс и запускает сервер, и подключается к нему.
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 ?? '';
}
}protected static function components(Components $components): void
{
$components->service(MainRedisConfig::service());
}Хранилище ссылается на неё:
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 процесса, который написал строку: самого сервера или дочернего, который
сохраняет снимок.
[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 придёт посреди сохранения, и после старта будут
данные прошлого снимка.
Дальше
- Сервисы — что это и как устроено.
- PostgreSQL и MariaDB — другие готовые сервисы.
- Конфигурация Redis —
RedisConfigи пул соединений.