116 lines
3.2 KiB
Markdown
116 lines
3.2 KiB
Markdown
|
# ShopXO 缓存速查手册
|
|||
|
|
|
|||
|
|
## 核心结论
|
|||
|
|
|
|||
|
|
| 命题 | 结论 |
|
|||
|
|
|------|------|
|
|||
|
|
| 数据库查询自动缓存？ | ❌ 否，必须手动显式包裹 |
|
|||
|
|
| 哪些查询被缓存？ | 仅代码中用 `MyCache()` / `cache()` 包装的 |
|
|||
|
|
| `Db::name('x')->find()` 自动走 Redis？ | ❌ 直击 DB，无中间层 |
|
|||
|
|
| 缓存驱动切换 | 由后台 `common_data_is_use_redis_cache` 控制（0=file, 1=redis） |
|
|||
|
|
| Redis 参数来源 | 从数据库配置表读取（host/port/password） |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 缓存调用方式
|
|||
|
|
|
|||
|
|
### ShopXO 自有的 `MyCache()`
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
// 读取（为空触发重新查询）
|
|||
|
|
$data = MyCache($key);
|
|||
|
|
|
|||
|
|
// 写入（第三参数 = 秒数 expire）
|
|||
|
|
MyCache($key, $data, 3600);
|
|||
|
|
|
|||
|
|
// 删除
|
|||
|
|
MyCache($key, null);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### ThinkPHP 原生 `cache()`
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
cache($key, $value, $expire_seconds);
|
|||
|
|
cache($key, null); // 删除
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## vr_ticket 插件缓存策略
|
|||
|
|
|
|||
|
|
### 缓存场景
|
|||
|
|
|
|||
|
|
| 数据 | 缓存时间 | 原因 |
|
|||
|
|
|------|---------|------|
|
|||
|
|
| 座位模板（vr_seat_templates） | 86400s（1天） | 静态数据，变更少 |
|
|||
|
|
| 商品座位图渲染数据 | 3600s（1小时） | 商品信息不频繁改 |
|
|||
|
|
| 核销记录列表 | 300s（5分钟） | 需要一定实时性 |
|
|||
|
|
| 观演人信息 | ❌ 不缓存 | 隐私数据 |
|
|||
|
|
| 座位实时余量 | ❌ 不缓存 | 强一致性要求，走 DB |
|
|||
|
|
|
|||
|
|
### 缓存 Key 规范
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
vrticket:seat_template_{id} # 单个模板
|
|||
|
|
vrticket:seat_templates_list # 模板列表
|
|||
|
|
vrticket:goods_seat_map_{goods_id} # 商品座位图
|
|||
|
|
vrticket:verifications_list # 核销记录列表
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 数据变更时主动失效
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
// 模板更新后
|
|||
|
|
cache('vrticket:seat_template_' . $id, null);
|
|||
|
|
cache('vrticket:seat_templates_list', null);
|
|||
|
|
|
|||
|
|
// 核销记录新增后
|
|||
|
|
cache('vrticket:verifications_list', null);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 配置说明（config/cache.php）
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
'default' => (MyFileConfig('common_data_is_use_redis_cache','',0,true) == 1) ? 'redis' : 'file',
|
|||
|
|
|
|||
|
|
'stores' => [
|
|||
|
|
'redis' => [
|
|||
|
|
'host' => MyFileConfig('common_cache_data_redis_host','','127.0.0.1',true),
|
|||
|
|
'port' => MyFileConfig('common_cache_data_redis_port','',6379,true),
|
|||
|
|
'password' => MyFileConfig('common_cache_data_redis_password','','',true),
|
|||
|
|
'expire' => intval(MyFileConfig('common_cache_data_redis_expire','',0,true)),
|
|||
|
|
'prefix' => MyFileConfig('common_cache_data_redis_prefix','','redis_shopxo',true),
|
|||
|
|
],
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- 全局 `expire` = 0 表示永久（受实际 per-key expire 覆盖）
|
|||
|
|
- ShopXO 后台可配置 `common_data_is_use_cache` 全局开关（debug 模式下自动 bypass）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 防坑提示
|
|||
|
|
|
|||
|
|
1. **Debug 模式绕过缓存**：`MyEnv('app_debug')` 为 true 时所有 `MyCache()` 直接 miss
|
|||
|
|
2. **全局开关**：`MyC('common_data_is_use_cache') != 1` 时全部走 DB
|
|||
|
|
3. **超卖风险**：座位状态查询禁止缓存，必须实时查 DB + `FOR UPDATE SKIP LOCKED`
|
|||
|
|
4. **MyCache 静态复用**：同一请求内同一 key 只调一次底层 `cache()`（in-request 内存缓存）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 快速上手模板
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
// 读缓存
|
|||
|
|
$key = 'vrticket:seat_template_' . $templateId;
|
|||
|
|
$data = MyCache($key);
|
|||
|
|
if ($data === null) {
|
|||
|
|
$data = Db::name('SeatTemplate')->where(['id'=>$templateId])->find();
|
|||
|
|
MyCache($key, $data, 86400);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 写操作后清缓存
|
|||
|
|
cache('vrticket:seat_template_' . $templateId, null);
|
|||
|
|
```
|