Поиск
Справочник

Laravel и Redis на сервере: кеш, сессии и очереди

В новом проекте Laravel хранит кеш, сессии и очереди в базе данных. Их можно перенести в Redis — хранилище в оперативной памяти: страницы с кешем отвечают быстрее, а база данных разгружается. Для этого на сервере нужны сам Redis и расширение PHP, а в .env — несколько строк. Ниже — какие строки, где Laravel хранит данные в Redis и что проверить после переключения.

≈ 7 мин чтения
Содержание 13

Что сделать прямо сейчас

  1. Поставьте Redis, если его ещё нет на сервере, — Установка Redis.
  2. Поставьте расширение PHP: sudo apt install php-redis и перезапустите PHP-FPM: sudo systemctl restart php8.3-fpm.
  3. Откройте .env проекта: nano /var/www/example.com/.env — и впишите строки ниже.
  4. Соберите кеш настроек и перезапустите воркеры: sudo -u www-data php artisan config:cache и sudo -u www-data php artisan queue:restart.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Проект в примерах лежит в /var/www/example.com, Redis работает на этом же сервере.

Что можно хранить в Redis

ЧтоСтрока в .envВ новом проекте
кешCACHE_STORE=redisdatabase
сессии посетителейSESSION_DRIVER=redisdatabase
очереди задачQUEUE_CONNECTION=redisdatabase

Переключать можно по одному: например, только кеш, а сессии и очереди оставить в базе данных.

Расширение PHP

Laravel подключается к Redis через расширение PHP redis — в настройках оно называется phpredis. Поставьте его и перезапустите PHP-FPM:

sudo apt install php-redis
sudo systemctl restart php8.3-fpm

Проверка: php -m | grep redis — в ответе должна быть строка redis. Команда для Ubuntu 24.04, где стоит PHP 8.3; как узнать свою версию — Установка PHP.

Если поставить расширение нельзя, документация Laravel предлагает пакет Predis — он написан на PHP и расширения не требует:

cd /var/www/example.com
composer require predis/predis

Тогда в .env укажите REDIS_CLIENT=predis.

Строки в .env

REDIS_CLIENT=phpredis
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
СтрокаЧто значит
REDIS_CLIENT=phpredisподключаться через расширение PHP redis
REDIS_HOST=127.0.0.1Redis на этом же сервере
REDIS_PASSWORD=nullпароля нет; если пароль задан — впишите его вместо null
REDIS_PORT=6379порт Redis
CACHE_STORE=redisкеш в Redis
SESSION_DRIVER=redisсессии в Redis
QUEUE_CONNECTION=redisочереди в Redis

Строки REDIS_… уже есть в .env нового проекта — поправьте их, а не добавляйте вторые. Если Redis закрыт паролем, а для сайта заведён отдельный пользователь, добавьте строку REDIS_USERNAME=имя. Как задать пароль — Пароль и пользователи Redis. Как устроен файл .env — .env на сервере.

Где Laravel хранит данные в Redis

Внутри Redis 16 отдельных баз с номерами от 0 до 15. Laravel берёт две:

СоединениеСтрока в .envПо умолчаниюЧто там лежит
defaultREDIS_DB0очереди и сессии
cacheREDIS_CACHE_DB1кеш

Посмотреть, сколько ключей в базе кеша: redis-cli -n 1 DBSIZE. Если на Redis стоит пароль, войдите с ним — redis-cli. Подробнее о базах — Базы и ключи Redis.

Что стирает cache:clear

sudo -u www-data php artisan cache:clear

Ответ: Application cache cleared successfully. С кешем в Redis команда очищает всю базу кеша — номер из REDIS_CACHE_DB, а не только ключи вашего сайта. Документация Laravel предупреждает: очистка кеша не учитывает префикс.

Пока в базе 1 лежит только кеш этого сайта, это не страшно: кеш соберётся заново. Если в ту же базу пишет другой сайт или программа, их данные тоже пропадут — дайте каждому сайту свои базы, как в примере ниже.

Два сайта на одном Redis

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

Дайте каждому сайту свои базы и свой префикс. В .env второго сайта:

REDIS_DB=2
REDIS_CACHE_DB=3
REDIS_PREFIX=example-staging-database-
СайтREDIS_DBREDIS_CACHE_DB
первый01
второй23
третий45

После переключения

Что переключилиЧто произойдётЧто сделать
сессиипосетители выйдут из аккаунтов: старые сессии остались в базе данныхничего — войдут заново
очередизадачи, которые уже лежали в таблице jobs, воркер больше не видитдоделайте их: sudo -u www-data php artisan queue:work database --stop-when-empty
кешкеш начнёт собираться зановоничего

После любой правки .env соберите кеш настроек: sudo -u www-data php artisan config:cache. Воркеры очереди держат старые настройки в памяти — перезапустите их: sudo -u www-data php artisan queue:restart. Подробнее — Очереди и Supervisor.

Память Redis

Если для Redis задан предел памяти maxmemory с политикой allkeys-lru, при нехватке памяти он удаляет любые ключи — не только кеш, но и сессии и задачи очереди. Когда в одном Redis лежат кеш и очереди, выберите другую политику — какую.

Как проверить

cd /var/www/example.com
php artisan about --only=drivers

В строках Cache, Queue и Session должно стоять redis. Если там database, Laravel читает старые настройки — выполните sudo -u www-data php artisan config:cache. Подробнее — php artisan about.

Откройте пару страниц сайта и выполните redis-cli -n 1 DBSIZE — число ключей в базе кеша должно вырасти.

Ошибки и как их исправить

Что видитеПричинаЧто делать
Please make sure the PHP Redis extension is installed and enabled.нет расширения PHP redissudo apt install php-redis и sudo systemctl restart php8.3-fpm
NOAUTH Authentication required.на Redis пароль, а в .env его нетРазбор
WRONGPASS invalid username-password pair or user is disabled.неверный пароль или имя в .envРазбор
в laravel.log RedisException и отказ в соединенииRedis не запущен или неверный REDIS_HOSTРазбор
OOM command not allowed when used memory > 'maxmemory'.Redis упёрся в предел памятиРазбор
поправили .env, а в about по-прежнему databaseсобран кеш настроекsudo -u www-data php artisan config:cache
задачи перестали выполняться после переключенияворкеры не перезапущеныsudo -u www-data php artisan queue:restart
сайт показывает данные другого сайтаодинаковые APP_NAME и базы Redisразведите базы

Тексты сообщений Laravel сверены по исходному коду Laravel 13.42.0.

Источники

Сверено 13 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше