К содержимому

Как настроить PHP Redis на сервере Ubuntu 24.04

Redis хранит кэш в памяти и снимает нагрузку с MySQL. На Ubuntu 24.04 он ставится пакетом redis-server версии 7.0, а для PHP нужен пакет php8.3-redis.

Руководство Redis 3 мин чтения

01Установите Redis

Пакет redis-server из репозитория Ubuntu 24.04 содержит Redis 7.0. После установки служба запускается сама и слушает только локальный адрес 127.0.0.1 на порту 6379.

bash
sudo apt update
sudo apt install redis-server

02Проверьте, что служба работает

Служба называется redis-server, у неё есть алиас redis. Команда redis-cli ping должна вернуть PONG. Если ответа нет, смотрите статус и лог /var/log/redis/redis-server.log.

bash
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.

bash
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.

bash
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.

bash
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
<?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.

ini
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.

bash
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 на своём сервере: установка и настройка: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.