Debian下Laravel怎样用Redis

在 Debian 下让 Laravel 使用 Redis，通常分为 安装 Redis → 安装 PHP Redis 扩展 → 配置 Laravel 三步。下面按常见场景说明。

一、安装 Redis（Debian）

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Redis

sudo apt install redis-server -y

3. 启动并设置开机自启

sudo systemctl enable redis-server
sudo systemctl start redis-server

4. 测试 Redis

redis-cli ping
# 返回 PONG 说明正常

二、安装 PHP Redis 扩展

Laravel 推荐使用 phpredis（C 扩展）

1. 安装扩展

sudo apt install php-redis -y

如果你使用的是 PHP 8.2：

sudo apt install php8.2-redis

2. 重启 PHP / Web 服务

# PHP-FPM
sudo systemctl restart php8.2-fpm

# 或 Apache
sudo systemctl restart apache2

3. 确认扩展已加载

php -m | grep redis

三、配置 Laravel 使用 Redis

1. 安装 Laravel Redis 依赖（可选）

使用 phpredis 时不需要 predis，但 Laravel 仍兼容

composer require predis/predis

（不装也可以，Laravel 默认用 phpredis）

2. 配置 .env

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

3. 配置 config/database.php

默认已配置好，关键部分如下：

'redis' => [
    'client' => 'phpredis', // 或 predis
    'default' => [
        'host' => env('REDIS_HOST', '127.0.0.1'),
        'password' => env('REDIS_PASSWORD'),
        'port' => env('REDIS_PORT', 6379),
        'database' => 0,
    ],
],

四、Laravel 中使用 Redis

1. 缓存（Cache）

CACHE_DRIVER=redis

use Illuminate\Support\Facades\Cache;

Cache::put('name', 'Laravel', 600);
echo Cache::get('name');

2. Session

SESSION_DRIVER=redis

3. 队列（Queue）

QUEUE_CONNECTION=redis

启动队列：

php artisan queue:work redis

4. 直接使用 Redis

use Illuminate\Support\Facades\Redis;

Redis::set('foo', 'bar');
echo Redis::get('foo');

五、常见问题

1. Redis 连接失败

• 检查 redis-server 是否运行
• 检查防火墙
• 检查 REDIS_HOST

2. 多数据库

'cache' => [
    'host' => '127.0.0.1',
    'port' => 6379,
    'database' => 1,
],

3. 远程 Redis

REDIS_HOST=192.168.1.100

六、推荐生产配置

• 设置 Redis 密码
• 限制最大内存
• 使用 phpredis
• 队列 + 缓存分离数据库

如果你告诉我：

• Laravel 版本
• PHP 版本
• 是否用 Docker / 宝塔 / LNMP

我可以给你更精确的配置示例。