根据请求参数生成唯一缓存键，确保不同参数不共用缓存；2. 使用Redis存储接口响应，先读缓存命中则返回，未命中则执行业务并回填；3. 注意剔除敏感参数、合理设置TTL、添加前缀管理；4. Redis异常时捕获错误降级查询数据库，保障服务可用。
在高并发的API服务中，缓存是提升响应速度和降低数据库压力的关键手段。PHP结合Redis实现接口缓存，能显著提高性能。核心思路是：根据API请求参数生成唯一的缓存键（cache key），将结果存入Redis，下次相同请求直接读取缓存。
1. 根据请求参数生成Cache Key
为了确保不同参数的请求不会共用同一缓存，必须将请求参数纳入缓存键的生成逻辑。常用方法是将GET或POST参数按固定顺序排序后序列化，并加上接口路径。
示例代码：
function generateCacheKey($uri, $params) {
// 参数按键名排序，避免参数顺序不同导致key不同
ksort($params);
// 将参数数组转为标准化字符串
$paramString = http_build_query($params, '', '&', PHP_QUERY_RFC3986);
// 使用md5缩短长度，同时保证唯一性
return 'api:' . md5($uri . '?' . $paramString);
}
例如请求 /api/user?status=1&sort=name 和 /api/user?sort=name&status=1 会生成相同的key，避免重复缓存。
立即学习“PHP免费学习笔记（深入）”；
2. 使用Redis存储与读取缓存
PHP通过Redis扩展（如phpredis）连接Redis服务器，实现缓存的存取操作。每次请求先查缓存，命中则返回，未命中则执行业务逻辑并回填缓存。
缓存处理流程：
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$cacheKey = generateCacheKey($_SERVER['REQUEST_URI'], $_GET);
// 尝试从Redis获取缓存
$cached = $redis->get($cacheKey);
if ($cached !== false) {
header('Content-Type: application/json');
echo $cached;
exit;
}
// 缓存未命中，执行实际业务逻辑
$data = [
'code' => 0,
'msg' => 'success',
'data' => getUserList($_GET) // 假设这是你的数据查询函数
];
$jsonData = json_encode($data, JSON_UNESCAPED_UNICODE);
$redis->setex($cacheKey, 300, $jsonData); // 缓存5分钟
header('Content-Type: application/json');
echo $jsonData;
3. 注意事项与优化建议
- 敏感参数如token、sign不应参与cache key生成，避免泄露或缓存污染
- 对分页类接口（如page、limit）特别注意，确保分页参数被正确包含
- 设置合理的过期时间（TTL），防止数据长期不更新
- 可加入缓存预热机制，在低峰期主动加载热点数据
- 使用前缀（如 api:）便于管理和批量清理特定类型缓存
4. 异常处理与降级策略
Redis不可用时不应导致API失败。建议添加异常捕获，Redis异常时自动降级为直接查询数据库。
try {
$cached = $redis->get($cacheKey);
} catch (RedisException $e) {
// Redis异常，记录日志，继续执行原逻辑
error_log('Redis error: ' . $e->getMessage());
$cached = false;
}
这样系统更具容错能力。
基本上就这些。合理利用请求参数生成唯一key，配合Redis快速存取，能让PHP API性能提升明显。
