laravel如何使用Redis进行缓存和队列_Laravel Redis缓存与队列使用教程

Laravel通过配置Redis实现高性能缓存与队列，先在.env文件设置Redis连接参数并指定CACHE_DRIVER=redis和QUEUE_CONNECTION=redis，结合phpredis扩展提升性能；使用Cache门面或cache()函数操作缓存，通过dispatch分发队列任务，配合queue:work命令处理异步逻辑，并可配置不同数据库分离缓存与队列、启用失败队列记录，实现高效稳定的任务管理。

Laravel 使用 Redis 作为缓存和队列驱动非常方便，Redis 不仅性能高，还支持多种数据结构和持久化机制。下面详细介绍如何在 Laravel 中配置并使用 Redis 实现缓存和队列功能。

配置 Redis 环境

确保你的系统已安装并运行 Redis 服务。Laravel 默认使用 predis/predis 或 phpredis 扩展与 Redis 通信。

在 .env 文件中设置 Redis 连接信息：

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
REDIS_DB=0

在 config/database.php 中确认 Redis 配置项正确：

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

使用 Redis 作为缓存驱动

将 Laravel 的缓存默认驱动切换为 redis。

修改 .env 文件：

CACHE_DRIVER=redis

之后你可以使用 Laravel 的 Cache 门面进行缓存操作：

use Illuminate\Support\Facades\Cache;

// 存储缓存 10 分钟
Cache::put('user_1', ['name' => 'John', 'age' => 30], 600);

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

// 判断缓存是否存在
if (Cache::has('user_1')) {
    //
}

// 永久存储
Cache::forever('settings', $config);

// 删除缓存
Cache::forget('user_1');
Cache::flush(); // 清空所有（慎用）

你也可以使用辅助函数 cache()：

cache(['key' => 'value'], 3600);
$value = cache('key');

使用 Redis 作为队列驱动

队列用于异步处理耗时任务，如发送邮件、处理上传等。

AssemblyAI

转录和理解语音的AI模型

下载

修改 .env 文件启用 Redis 队列驱动：

QUEUE_CONNECTION=redis

创建一个队列任务：

php artisan make:job SendWelcomeEmail

在生成的 SendWelcomeEmail.php 中定义任务逻辑：

public function handle()
{
    // 发送邮件逻辑
    Mail::to($this->user)->send(new WelcomeMail());
}

在控制器中分发任务：

use App\Jobs\SendWelcomeEmail;

dispatch(new SendWelcomeEmail($user));
// 或者
SendWelcomeEmail::dispatch($user);

启动队列监听器处理任务：

php artisan queue:work

队列数据会存储在 Redis 的 queues:default list 中，你可以通过 redis-cli 查看：

redis-cli
LRANGE queues:default 0 -1

高级配置与优化建议

• 连接分离：可为缓存和队列配置不同的 Redis 数据库（如 DB 1 用于缓存，DB 2 用于队列）
• 序列化方式：Redis 默认使用 PHP 序列化，可改为 JSON 提高跨语言兼容性
• 超时控制：在队列任务中设置 timeout 和 tries 避免卡死
• 失败队列：启用 failed_jobs 表记录失败任务，便于重试

启用失败队列：

php artisan queue:failed-table
php artisan migrate

配置 .env：

QUEUE_FAILED_DATABASE=redis