# 4.8 缓存架构设计

:::tip 概述
项目采用两级缓存架构：请求级缓存（内存）+ 持久缓存（file/Redis），大幅减少数据库查询。
:::

## 两级缓存架构

```text
┌─────────────────────────────────────────────────────────┐
│ 第一级：请求级缓存（static 变量）                        │
│                                                         │
│ 生命周期：单次 HTTP 请求                                 │
│ 存储位置：PHP 内存（static $cache）                      │
│ 速度：极快（纳秒级）                                     │
│                                                         │
│ 同一请求内多次查询同一数据，只查一次库或缓存             │
└──────────────────────────┬──────────────────────────────┘
                           │ 未命中
                           ▼
┌─────────────────────────────────────────────────────────┐
│ 第二级：持久缓存（cache() 门面）                         │
│                                                         │
│ 生命周期：跨请求复用                                     │
│ 存储位置：file 或 Redis                                  │
│ 速度：快（毫秒级）                                       │
│ 有效期：1 小时（3600 秒）                                │
│                                                         │
│ 跨请求复用，减少数据库压力                               │
└──────────────────────────┬──────────────────────────────┘
                           │ 未命中
                           ▼
┌─────────────────────────────────────────────────────────┐
│ 数据库查询                                               │
│                                                         │
│ 查询后同时写入两级缓存                                   │
└─────────────────────────────────────────────────────────┘
```

## 使用两级缓存的服务

| 服务 | 缓存键格式 | 说明 |
|------|-----------|------|
| `DictService` | `dict_{code}` | 字典项映射 |
| `DictService` | `dict_full_{code}` | 字典项完整数据 |
| `ParamService` | `param_{code}` | 系统参数值 |

## 缓存驱动配置

`.env` 配置：

```ini
; 文件缓存（默认）
[CACHE]
DRIVER = file

; Redis 缓存（推荐生产环境）
[CACHE]
DRIVER = redis
REDIS_HOST = 127.0.0.1
REDIS_PORT = 6379
REDIS_PASSWORD =
REDIS_DB = 0
```

:::warning 生产环境建议使用 Redis
文件缓存在多进程/多服务器环境下无法共享，生产环境建议配置 Redis 缓存驱动。使用 Redis 前需安装 `php redis` 扩展。
:::

## 缓存清除

```php
// 清除指定字典缓存
DictService::clearCache('gender');

// 清除所有字典缓存
DictService::clearAllCache();

// 清除指定参数缓存
ParamService::clearCache('DEFAULT_PASSWORD');

// 清除所有参数缓存
ParamService::clearAllCache();
```

对应接口：

```text
GET /api/dict/refreshCache    刷新字典缓存
```