Laravel怎么配置和使用Redis进行缓存-Laravel-PHP中文网

Laravel怎么配置和使用Redis进行缓存

冰火之心

发布： 2025-11-24 08:22:02

原创

540人浏览过

配置Laravel使用Redis缓存需安装Predis或phpredis，设置.env中CACHE_DRIVER=redis，并在config/database.php中配置redis连接，确保cache连接指向正确数据库；通过Cache门面如put、get、remember等方法操作缓存，推荐使用独立database避免冲突，注意连接名称与配置一致。

laravel怎么配置和使用redis进行缓存

在 Laravel 中配置和使用 Redis 作为缓存驱动非常简单。Laravel 已经集成了对 Redis 的支持，你只需要正确配置并调用缓存门面即可。

安装和配置 Redis 扩展

确保你的服务器已经安装了 Redis 服务，并且 PHP 安装了 php redis 或 predis/predis 扩展。推荐使用 Composer 安装 Predis：

composer require predis/predis

如果你使用的是 phpredis 扩展，则无需通过 Composer 安装，但需要确保 PHP 模块已启用。

配置 .env 和 cache.php

打开项目根目录下的 .env 文件，修改缓存驱动为 redis：

CACHE_DRIVER=redis

Laravel 默认的缓存配置文件位于 config/cache.php。确认 'default' 驱动设置为 redis，或保留为 CACHE_DRIVER 环境变量控制。

同时检查 stores.redis 配置项，确保连接参数正确：

'redis' => [
    'driver' => 'redis',
    'connection' => 'cache', // 对应 config/database.php 中的 redis 连接
    'lock_connection' => 'default',
],

登录后复制

配置 Redis 连接（database.php）

打开 config/database.php，找到 redis 配置部分。默认情况下会有一个 cache 连接：

'redis' => [
    'client' => 'predis', // 或 'phpredis'
    'options' => [
        'prefix' => 'laravel_', // 可选：添加键前缀
        'schema' => 'tcp'
    ],
    'default' => [
        'host' => env('REDIS_HOST', '127.0.0.1'),
        'password' => env('REDIS_PASSWORD', null),
        'port' => env('REDIS_PORT', 6379),
        'database' => 0,
    ],
    'cache' => [
        'host' => env('REDIS_HOST', '127.0.0.1'),
        'password' => env('REDIS_PASSWORD', null),
        'port' => env('REDIS_PORT', 6379),
        'database' => 1, // 推荐使用独立数据库用于缓存
    ],
],

登录后复制

你可以根据环境变量调整主机、端口和密码。

Getfloorplan

创建 2D、3D 平面图和 360° 虚拟游览，普通房间变成梦想之家

148

查看详情

使用缓存门面操作 Redis 缓存

Laravel 提供了 Cache 门面来统一操作缓存，无论底层是 Redis 还是其他驱动。

示例代码：

use Illuminate\Support\Facades\Cache;

// 存储一个键值，有效期为 10 分钟
Cache::put('user_1', ['name' => 'Tom', 'age' => 25], 600);

// 获取缓存
$user = Cache::get('user_1');

// 如果不存在则存储（原子操作）
Cache::remember('user_1', 600, function () {
    return User::where('id', 1)->first();
});

// 删除缓存
Cache::forget('user_1');

// 清空所有缓存（谨慎使用）
Cache::flush();

登录后复制

你也可以使用 Cache::has() 判断是否存在，Cache::add() 添加仅当键不存在时生效。

直接使用 Redis 实例（可选）

如果需要直接操作 Redis，可以使用 Redis 门面：

use Illuminate\Support\Facades\Redis;

Redis::set('test_key', 'test_value');
$value = Redis::get('test_key');
Redis::expire('test_key', 300); // 设置过期时间

登录后复制

注意：这种方式绕过了缓存系统，不推荐用于通用缓存逻辑，适合特殊场景如队列、计数器等。

基本上就这些。只要配置好 .env 和 database.php，再使用 Cache 门面，就能在 Laravel 中高效使用 Redis 做缓存。不复杂但容易忽略的是数据库编号和连接名称的匹配问题，记得把 cache 使用的 connection 指向正确的 redis 配置块。

以上就是Laravel怎么配置和使用Redis进行缓存的详细内容，更多请关注php中文网其它相关文章！