PHPAPI缓存怎么设计

wen PHP项目 2026-07-07 2

PHP API缓存设计：从入门到精通的架构实践指南

目录导读

为什么需要API缓存？
缓存设计的核心原则
主流缓存策略深度解析
实战：基于Redis的分层缓存方案
缓存穿透、击穿、雪崩的应对
常见问题FAQ

为什么需要API缓存？

在高并发场景下，每一次API请求都直接查询数据库会导致响应延迟激增（通常300ms+），甚至引发数据库连接耗尽，设计合理的PHP API缓存机制，可以将响应时间压缩到10ms以内，吞吐量提升10倍以上，以电商平台商品详情接口为例，未缓存时QPS（每秒查询数）仅500，缓存命中率达到90%后,QPS可提升至5000。

PHPAPI缓存怎么设计

缓存设计的核心原则

分层缓存策略：内存缓存（APCu/Redis）→ 本地文件缓存 → 数据库
TTL（生存时间）差异化：高频静态数据（如城市列表）设置24小时，动态数据（如用户余额）设5分钟
缓存粒度控制：对API响应体按{API版本}_{参数哈希}生成唯一键，避免版本混乱
数据一致性问题：当数据更新时，必须执行“更新数据库→删除缓存→延迟双删”的流程

主流缓存策略深度解析

1 全页面缓存（适合公开API）

// 缓存整个Response
$key = 'page_' . md5($_SERVER['REQUEST_URI']);
if ($cached = $redis->get($key)) {
    return json_decode($cached, true);
}
$data = fetchFromDatabase();
$redis->setex($key, 300, json_encode($data)); // 5分钟过期

2 片段缓存（适合动态组件）

对用户头像这类高频请求片段单独缓存,避免影响主页整体TTL。

3 数据源缓存（ORM层缓存）

使用Doctrine或Eloquent的二级缓存,将SQL查询结果暂存：

// Laravel类似
$users = Cache::remember('users_all', 3600, function() {
    return User::where('active', 1)->get();
});

实战：基于Redis的分层缓存方案

1 架构设计

Client → Nginx → PHP处理层 → Redis缓存 → MySQL
                           ↑
                    缓存失效监听器 (WebSocket/消息队列)

2 代码实现核心逻辑

class ApiCacheManager {
    private $redis;
    private $localCache = []; // 进程内缓存
    public function get($key, $ttl, callable $fallback) {
        // 第一层：进程内存
        if (isset($this->localCache[$key])) {
            return $this->localCache[$key];
        }
        // 第二层：Redis
        $cached = $this->redis->get($key);
        if ($cached !== false) {
            $this->localCache[$key] = $cached;
            return $cached;
        }
        // 第三层：数据库回源
        $value = $fallback();
        $this->redis->setex($key, $ttl, $value);
        $this->localCache[$key] = $value;
        return $value;
    }
    public function invalidate($pattern) {
        // 删除匹配模式的所有缓存
        foreach ($this->redis->keys($pattern) as $key) {
            $this->redis->del($key);
            unset($this->localCache[$key]);
        }
    }
}

3 热点数据预热

通过crontab在低峰期执行：

* */2 * * * php /var/www/api/warm_cache.php

缓存穿透、击穿、雪崩的应对

1 缓存穿透（查询不存在数据）

解决方案：布隆过滤器 + 空值缓存（TTL设短时间,比如60秒）

2 缓存击穿（热点Key过期）

解决方案：

互斥锁：只允许一个线程重建缓存
永不过期：后台定时更新（适合不严格要求即时的数据）

// 互斥锁实现
$lockKey = $key . '_LOCK';
if ($this->redis->setnx($lockKey, 1, 5)) { // 5秒锁超时
    $data = $fallback();
    $this->redis->setex($key, $ttl, $data);
    $this->redis->del($lockKey);
}