PHP如何用Redis缓存接口数据并设置过期时间?

梦磊小哥_1372

梦磊小哥_1372

2026-11-09

507人浏览

原创

使用redis缓存接口数据并设置过期时间,核心做法是先通过 get 方法查询缓存中是否存在目标键值。如果存在且未过期,直接返回该数据;如果不存在或已过期,则执行数据库查询获取最新数据,随后调用 setex 方法将数据存入redis并指定过期秒数。这样做既能保证后续请求快速响应,又能确保数据在设定周期后自动失效,避免脏数据长期驻留。

PHP如何用Redis缓存接口数据并设置过期时间?

如何判断缓存是否命中并处理空值情况?

在实现逻辑中,必须区分“缓存未命中”与“数据库中无数据”两种状态。如果直接使用 setex 存储空结果(如 false 或空数组),会导致正常业务数据被错误地标记为过期,引发雪崩或频繁穿透数据库的问题。正确的做法是检查数据库查询的返回值,仅当确实获取到有效数据时才写入缓存,或者针对空值使用专门的短时效策略进行隔离。

PHP如何用Redis缓存接口数据并设置过期时间?

<?php $redis = new Redis();
$redis->connect('127.0.0.1', 6379);

$key = 'api_user_data';
$expireTime = 3600; // 1小时

// 1. 尝试从缓存获取
$data = $redis->get($key);

if ($data !== false) {
    // 缓存命中,直接返回
    echo json_encode(['status' => 'hit', 'data' => unserialize($data)]);
} else {
    // 2. 缓存未命中,查询数据库(模拟)
    $dbData = fetchFromDatabase(); 
    
    if ($dbData !== null && !empty($dbData)) {
        // 3. 有数据,写入缓存并设置过期时间
        $serialized = serialize($dbData);
        $redis->setex($key, $expireTime, $serialized);
        echo json_encode(['status' => 'miss', 'data' => $dbData]);
    } else {
        // 4. 数据库也无数据,可选择缓存空值防止穿透
        $redis->setex($key, 60, ''); // 短时效缓存空值
        echo json_encode(['status' => 'empty', 'data' => null]);
    }
}

function fetchFromDatabase() {
    // 模拟数据库返回
    return ['id' => 1, 'name' => 'Test User'];
}
?>

如何确保高并发下缓存更新的原子性?

在高并发场景下,多个请求可能同时发现缓存失效,从而同时发起数据库查询,导致“缓存击穿”。虽然 setex 本身是原子操作,但它无法解决并发写入冲突。更稳健的做法是使用 setnx(SET If Not Exists)配合 expire,或者利用Redis的分布式锁机制。这里展示一种简化的基于 setnx 的单点更新策略:只有第一个获取到锁的请求才去查库并更新缓存,其他请求等待或重试。

Sentinal Redis
Sentinal Redis

监控Redis服务器健康状况、内存、性能及BullMQ队列。检查队列深度、失败任务,分析慢查询并诊断问题。

下载

PHP如何用Redis缓存接口数据并设置过期时间?

<?php $redis = new Redis();
$redis->connect('127.0.0.1', 6379);

$key = 'api_lock_key';
$dataKey = 'api_user_data';
$lockExpire = 5; // 锁持有时间5秒
$dataExpire = 3600;

// 尝试获取锁
$isLocked = $redis->set($key, 'locked', ['nx', 'ex' => $lockExpire]);

if ($isLocked) {
    try {
        // 双重检查:获取锁后再次确认缓存是否已被其他线程填充
        $data = $redis->get($dataKey);
        if ($data === false) {
            // 执行耗时操作:查库
            $dbData = fetchFromDatabase();
            if ($dbData) {
                $redis->setex($dataKey, $dataExpire, serialize($dbData));
            }
        }
    } finally {
        // 释放锁
        $redis->del($key);
    }
}

// 无论是否加锁成功,最终都读取当前缓存
$result = $redis->get($dataKey);
echo $result ? unserialize($result) : 'No Data';
?>

当接口参数变化时,如何设计合理的缓存键?

缓存键的设计直接决定了数据的准确性。如果接口支持分页、排序或多条件筛选,简单的固定键名会导致数据混淆。例如,用户A请求第1页和用户B请求第2页,如果使用相同的键 api_users,后者会覆盖前者的缓存。因此,必须将关键查询参数(如 page, sort, filter_id)哈希或拼接进键名中,形成唯一的标识符,确保不同条件的请求互不干扰。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

12464

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

7201

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2235

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4528

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

5234

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

4111

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5977

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4682

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12482

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
《20天入门精通PHP》视频教程
《20天入门精通PHP》视频教程

共200课时 | 49.4万人学习

墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习