Как настроить PHP Redis на сервере Ubuntu 24.04
Redis хранит кэш в памяти и снимает нагрузку с MySQL. На Ubuntu 24.04 он ставится пакетом redis-server версии 7.0, а для PHP нужен пакет php8.3-redis.
01Установите Redis
Пакет redis-server из репозитория Ubuntu 24.04 содержит Redis 7.0. После установки служба запускается сама и слушает только локальный адрес 127.0.0.1 на порту 6379.
sudo apt update
sudo apt install redis-server
02Проверьте, что служба работает
Служба называется redis-server, у неё есть алиас redis. Команда redis-cli ping должна вернуть PONG. Если ответа нет, смотрите статус и лог /var/log/redis/redis-server.log.
sudo systemctl status redis-server
redis-cli ping
sudo tail -n 50 /var/log/redis/redis-server.log
03Задайте лимит памяти и политику вытеснения
По умолчанию maxmemory 0, лимита нет, а политика noeviction запрещает удалять ключи. Для кэша задайте лимит и allkeys-lru, чтобы старые ключи вытеснялись. Настройки можно применить на ходу и записать в redis.conf командой CONFIG REWRITE.
redis-cli CONFIG SET maxmemory 256mb
redis-cli CONFIG SET maxmemory-policy allkeys-lru
redis-cli CONFIG REWRITE
redis-cli CONFIG GET maxmemory
04Включите overcommit, чтобы не падало сохранение
В логе при старте бывает WARNING Memory overcommit must be enabled!. Без vm.overcommit_memory = 1 фоновое сохранение RDB может упасть при нехватке памяти. Параметр пишут в отдельный файл в /etc/sysctl.d/ и применяют командой sudo sysctl --system.
echo 'vm.overcommit_memory = 1' | sudo tee /etc/sysctl.d/99-redis.conf
sudo sysctl --system
05Установите расширение php8.3-redis
Пакет php8.3-redis содержит phpredis 5.3.7 и есть в репозитории Ubuntu. После установки перезагрузите PHP-FPM, иначе расширение не подхватится в веб-процессах. Для CLI проверка простая: php -m | grep redis.
sudo apt install php8.3-redis
sudo systemctl reload php8.3-fpm
php -m | grep redis
06Подключитесь к Redis из PHP
Класс Redis из расширения создаёт соединение с локальным портом 6379. Если в redis.conf задан requirepass, пароль передают отдельным вызовом $redis->auth('пароль'), а не вторым аргументом connect. Без пароля при заданном requirepass скрипт получит NOAUTH Authentication required..
<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$redis->auth('пароль');
$redis->set('test', 'ok');
echo $redis->get('test');
07Настройте Laravel на Redis
Laravel берёт параметры из .env: REDIS_HOST=127.0.0.1, REDIS_PORT=6379 и REDIS_PASSWORD. Клиент задаёт REDIS_CLIENT: значение phpredis требует установленного расширения, predis ставится через Composer. Если расширения нет, Laravel падает с Class "Redis" not found.
REDIS_CLIENT=phpredis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=null
08Проверьте кэш и сохранение на диск
Запись и чтение ключа через redis-cli показывают, что служба отвечает. Команда INFO memory выводит занятую память и лимит maxmemory. Снимок RDB лежит в /var/lib/redis/dump.rdb, и при ошибке записи Redis вернёт MISCONF.
redis-cli set cache:test 1
redis-cli get cache:test
redis-cli INFO memory
sudo ls -l /var/lib/redis/dump.rdb
Частые ошибки
-
После правки
redis.confвы выполняетеsudo systemctl reload redis-server, но получаете ошибку: в unit-файле нетExecReload.Перезапускайте службу командой
sudo systemctl restart redis-server. Часть настроек можно менять на ходу черезredis-cli CONFIG SETи сохранять в файл черезCONFIG REWRITE. -
PHP пишет
Class "Redis" not found, хотя Redis установлен.Установите расширение
sudo apt install php8.3-redisи перезагрузите PHP-FPM:sudo systemctl reload php8.3-fpm. Проверьтеphp -m | grep redis. -
Скрипт получает
NOAUTH Authentication required., потому что вredis.confзаданrequirepass, а клиент подключается без пароля.Передайте пароль в
$redis->auth('пароль')или в переменнойREDIS_PASSWORDв.env. Вredis-cliиспользуйте ключ-a. -
Запись в Redis отклоняется с
OOM command not allowed when used memory > 'maxmemory'.Для кэша задайте
maxmemory-policy allkeys-lru, чтобы старые ключи вытеснялись. Для очередей поднимитеmaxmemoryдо значения, которого хватает данным.
Deploykin
Как это делается в Deploykin
В Deploykin Redis ставится на сервер в один клик и настраивается формой: пароль, лимит памяти, политика вытеснения, AOF. Доступ для серверов кластера включается одним переключателем, bind и файрвол панель настроит сама.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Нужен ли пароль для Redis на локальном сервере?
По умолчанию Redis слушает только 127.0.0.1 с protected-mode yes, и снаружи недоступен. Пароль через requirepass задают, если к Redis подключаются другие процессы или серверы.
Чем отличается phpredis от predis в Laravel?
phpredis это расширение PHP, оно быстрее и ставится пакетом php8.3-redis. predis это библиотека на PHP, её ставят через Composer, и расширение для неё не нужно.
Как проверить, что расширение Redis подключено в PHP?
Выполните php -m | grep redis: в выводе будет строка redis. Для веб-процессов после установки нужен sudo systemctl reload php8.3-fpm.
Что делать при ошибке MISCONF Redis is configured to save RDB snapshots?
Проверьте свободное место командой df -h /var/lib/redis и права пользователя redis на каталог. Причина записана в /var/log/redis/redis-server.log.
Ещё по теме
- Руководство · Redis Как установить Redis на сервер Ubuntu 24.04 Пошаговая установка Redis на Ubuntu 24.04: apt, проверка службы, настройка памяти и пароля, PHP-расширение, проверка redis-cli ping и разбор частых ошибок.
- Руководство · Redis Как настроить Redis на Ubuntu 24.04 и работать с ним через redis-cli Установите Redis на Ubuntu 24.04, подключитесь через redis-cli, задайте пароль и лимит памяти, проверьте работу командами ping, INFO и CONFIG GET.
- Руководство · Redis Redis база данных: настройка на сервере Ubuntu 24.04 Пошаговая настройка Redis на Ubuntu 24.04: проверка службы, пароль, лимит памяти, сохранение на диск, PHP-расширение и проверка работы командами.
- Руководство · Redis Настройка Redis на Ubuntu 24.04: пошаговое руководство Пошаговая настройка Redis на Ubuntu 24.04: проверка службы, правка redis.conf, пароль, лимит памяти, сохранение на диск и проверка через redis-cli.
- Руководство · Redis Redis команды: пошаговое руководство с проверкой Пошаговое руководство по работе с Redis на Ubuntu 24.04: проверка службы, основные команды redis-cli, настройка памяти, пароля и проверка результата.
- Руководство · Redis Как работает Redis на Ubuntu 24.04: пошаговая настройка Разбираем, как работает Redis на Ubuntu 24.04: проверка службы, память, сохранение на диск, TTL, Streams и Cluster. Пошаговая настройка с командами и проверкой.
Redis на своём сервере: установка и настройка: все материалы темы