ThinkPHP模型怎么使用查询缓存标签_ThinkPHP按标签清除缓存指南【指南】-ThinkPHP-PHP中文网

ThinkPHP模型的cache()方法仅设置缓存键名，不支持缓存标签；真正按标签管理需手动使用Cache::tag()配合序列化结果存储与读取。

thinkphp模型怎么使用查询缓存标签_thinkphp按标签清除缓存指南【指南】

ThinkPHP 的模型查询缓存本身不支持原生「缓存标签（tag）」机制，cache() 方法传入的字符串参数（如 'user_list'）只是缓存键名，不是可批量管理的标签。真要用标签做按组清除，得绕过模型默认缓存，手动对接底层缓存驱动。

为什么 `cache('tag_name')` 不是缓存标签

很多人在模型里写 UserModel::where('status', 1)->cache('user')->select()，以为 'user' 是标签，其实它只是生成缓存键的一部分（最终键可能是 think:UserModel:xxx），底层并未调用缓存驱动的 tag() 方法。所以用 Cache::clear('user') 或 Cache::tag('user')->clear() 都无效。

cache('user') → 仅设置缓存键前缀，不启用标签功能
ThinkPHP 6.x 默认缓存驱动（如 File、Redis）中，tag() 是独立接口，模型查询不自动绑定
只有显式调用 Cache::tag('user')->set($key, $value) 才真正打上标签

如何让模型查询走带标签的缓存

必须跳过模型的 cache()，改用缓存门面 + 手动序列化查询结果。核心思路：先构造唯一缓存键，再用 Cache::tag() 存储。

用 md5(json_encode($query->getOptions())) 或业务规则生成稳定键名，比如 'user_list_status_1'
查库前先 Cache::tag('user')->get($key)，命中则直接返回
未命中则执行 $query->select()，再 Cache::tag('user')->set($key, $result, 3600)
注意：select() 返回的是 Collection，需用 $result->toArray() 再缓存，否则反序列化可能失败

示例：

$key = 'user_list_status_1';
$result = Cache::tag('user')->get($key);
if (is_null($result)) {
    $result = UserModel::where('status', 1)->select()->toArray();
    Cache::tag('user')->set($key, $result, 3600);
}

按标签清除缓存的正确姿势

只有用 Cache::tag('xxx') 存过的数据，才能用对应标签清除。模型自带 cache(true) 或 cache('key') 的数据完全不受影响。

清除全部用户相关缓存：Cache::tag('user')->clear()
清除 Redis 下所有带 user 标签的项（File 驱动也支持）
不能混用：用 Cache::store('redis')->tag('user') 存的，就不能用 Cache::store('file')->tag('user') 清
多级缓存场景下，标签只作用于当前 store 实例，跨驱动不共享

容易被忽略的兼容性细节

标签功能在 ThinkPHP 6.0+ 中依赖缓存驱动是否实现 TagSetInterface。File、Redis、Memcached 驱动支持，但 Apcu、Xcache 等不支持标签，调用 tag() 会静默退化为普通缓存。

检查驱动是否支持：Cache::tag('test')->set('x', 'y') 后再 Cache::tag('test')->clear()，确认是否真清掉
Redis 驱动下，标签实际通过 zSet 维护索引，若 Redis 内存满或 key 过期策略激进，可能导致标签索引丢失
模型事件（如 afterWrite）里清除缓存时，务必用和写入时相同的 store 和 tag 实例

真要靠标签做缓存治理，就得放弃模型的快捷 cache()，全程手管键名、标签、序列化逻辑——省事和可控，得选一个。