linux laravel怎么集成redis

在 Linux + Laravel 环境下集成 Redis，一般分为 安装 Redis → 安装 PHP Redis 扩展 → 配置 Laravel → 使用 Redis 四个步骤。下面以 Laravel 9/10/11 + Ubuntu/CentOS 为例说明。

一、安装 Redis（Linux）

1. Ubuntu / Debian

sudo apt update
sudo apt install redis-server -y

启动并设置开机自启：

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

测试：

redis-cli ping
# 返回 PONG 说明成功

2. CentOS / Rocky / Alma

sudo yum install epel-release -y
sudo yum install redis -y
sudo systemctl enable redis
sudo systemctl start redis

二、安装 PHP Redis 扩展

1. 使用 pecl（推荐）

sudo apt install php-pear php-dev -y   # Ubuntu
# 或
sudo yum install php-pear php-devel -y # CentOS

sudo pecl install redis

然后在 php.ini 中启用：

extension=redis.so

重启 PHP：

sudo systemctl restart php-fpm
# 或
sudo systemctl restart apache2

2. 或使用 apt（简单）

sudo apt install php-redis

检查是否成功：

php -m | grep redis

三、配置 Laravel 使用 Redis

1. 安装 Laravel Redis 依赖（一般已自带）

composer require predis/predis
# 或直接使用 php-redis 扩展（推荐）

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. 缓存

use Illuminate\Support\Facades\Cache;

Cache::store('redis')->put('name', 'laravel', 600);
echo Cache::store('redis')->get('name');

2. 队列（常用）

.env

QUEUE_CONNECTION=redis

启动队列：

php artisan queue:work redis

3. 直接操作 Redis

use Illuminate\Support\Facades\Redis;

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

五、常见问题

1. Redis 连接失败

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

sudo ufw allow 6379

2. 生产环境安全

# /etc/redis/redis.conf
bind 127.0.0.1
requirepass yourpassword

3. 多数据库

Redis::select(1);

六、推荐用法

✅ 缓存
✅ Session
✅ 队列
✅ 分布式锁

如果你告诉我：

• Laravel 版本
• PHP 版本
• 是否用于队列 / 缓存 / 分布式

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