APCu 是单机轻量缓存最优解，两行代码（apcu_store/apcu_fetch）即可实现，需启用扩展并设 TTL、防穿透、规范键名。
用 apcu_store() 和 apcu_fetch() 最快落地
PHP 接口做缓存，不一定要上 Redis 或 Memcached——如果只是单机、轻量、读多写少的场景，apcu 是最省事的选择。它直接把数据存在 PHP 进程共享内存里，没有网络开销，apcu_store() 写入、apcu_fetch() 读取，两行代码就能生效。
前提是你得确认 APCu 已启用：extension=apcu.so（Linux）或 extension=php_apcu.dll（Windows），且 apc.enabled=1。用 phpinfo() 搜索 “APCu” 能快速验证。
常见错误：本地开发开了 APCu，但生产环境是 Docker 或 Nginx+PHP-FPM，默认没装 APCu 扩展，结果 apcu_fetch() 总返回 false 却不报错——记得加判空和降级逻辑。
缓存键设计必须带业务上下文
别直接用 $_GET['id'] 当缓存键，比如 apcu_store('user_'.$id, $data) 看似合理，但漏了几个关键点：
立即学习“PHP免费学习笔记（深入）”；
-
$id可能为空、非数字、含特殊字符——先过滤：$key = 'user_'.filter_var($id, FILTER_SANITIZE_NUMBER_INT); - 不同接口参数组合要区分，比如分页接口：
'user_list_page_'.$page.'_size_'.$limit，否则第 1 页缓存会覆盖第 2 页 - 用户登录态影响返回内容时，必须混入
$_SESSION['uid']或 token hash，否则缓存会串用户
建议统一用 sprintf() 或 md5(serialize($params)) 生成稳定键名，避免拼接出非法字符或超长键（APCu 键长度限制约 4K，但过长会拖慢查找）。
设置过期时间不是可选项，而是必填项
apcu_store() 第三个参数是 TTL（秒），不传就永不过期——这在开发时很爽，上线后就是事故源头。比如用户资料更新后，旧缓存还在，前端一直看到脏数据。
实际设多少？看数据更新频率：
- 配置类、字典表：300–3600 秒（5 分钟到 1 小时）
- 用户个人资料：60–300 秒（1–5 分钟，兼顾实时性与压力）
- 首页聚合数据：可设 60 秒，配合接口内部主动刷新（见下一点）
注意：apcu_store($key, $value, 300) 的 300 是“最多保留 300 秒”，不是“精确 300 秒后删除”，APCu 用 LRU 清理，高负载时可能提前淘汰。
缓存穿透和空值也要兜住
当接口被刷大量不存在的 id（比如 /api/user/999999999），每次查库都失败，缓存里又没对应 key，就会击穿到 DB。解决方案很简单：查不到也写一个空值或特殊标记进缓存，TTL 缩短（比如 60 秒）。
示例逻辑片段：
$key = 'user_'.$id;
$data = apcu_fetch($key);
if ($data === false) {
$data = query_db("SELECT * FROM users WHERE id = ?", [$id]);
if ($data === null) {
// 写空值，防止反复穿透
apcu_store($key, ['__empty' => true], 60);
} else {
apcu_store($key, $data, 300);
}
}这个 __empty 标记比直接存 null 更安全——因为 apcu_fetch() 查不到时也返回 false，你得靠结构区分“真没缓存”和“缓存了空结果”。
APCu 不支持原子性操作，所以别指望用它实现分布式锁或计数器；它只适合“读远大于写”的简单键值缓存。复杂场景该上 Redis 还得上。
