ThinkPHP5.1缓存tag标签,批量清理缓存使用场景-ThinkPHP-PHP中文网

thinkphp 5.1 中 cache() 函数的 tag 参数不能用于 file 驱动，仅 redis、memcached 驱动支持；apcu 驱动也不支持 tag，调用 clear('tag') 会静默失败，必须用 cache::store('redis')->tag('x')->clear() 显式指定驱动并链式调用。

thinkphp5.1缓存tag标签,批量清理缓存使用场景

ThinkPHP 5.1 中 `cache()` 的 tag 参数到底能不能用

不能直接用于 File 驱动，但 Redis/Memcache 驱动可以；File 驱动压根不实现 tag 功能，调用时不会报错，但 clear('tag_name') 会静默失败——这是最常踩的坑。

验证方式很简单：db('user')->cache('key', 3600, 'user_list')->select() 执行后，再运行 Cache::clear('user_list')，接着查 runtime/cache/ 目录下对应文件是否还在。如果还在，说明 tag 清理没生效，当前用的是 File 驱动。

只有 type 为 redis 或 memcache 的 store 才真正支持 tag
APCu 驱动（如前文配置的 'apcu'）也不支持 tag，它连 clear($tag) 方法都未实现
想用 tag 必须显式初始化带 tag 支持的缓存实例：Cache::store('redis')->tag('user')->set('profile_123', $data)

批量清理缓存的正确姿势：别依赖 `clear('tag')`，改用 `store()->tag()->clear()`

ThinkPHP 5.1 的 Cache::clear() 是全局清空，没有 tag 过滤能力；真正能按标签批量删的，是 store() 实例上的 tag() 链式调用。

例如，你用 Redis 存了一批用户相关缓存：

$redisCache = Cache::store('redis');
$redisCache->tag('user')->set('info_1001', ['name' => 'Alice'], 3600);
$redisCache->tag('user')->set('stats_1001', ['login_count' => 42], 3600);
$redisCache->tag('article')->set('hot_list', $list, 1800);

这时执行 $redisCache->tag('user')->clear() 就只会删掉前两条，第三条不受影响。

必须用 store('xxx') 拿到具体驱动实例，不能直接用 Cache:: 静态门面
tag() 必须在 set()/get() 前调用，且同一 tag 下所有 key 共享生命周期
File 驱动调用 store('file')->tag('x')->set() 不报错，但后续 clear() 无效，日志里也无提示

真实业务中哪些场景必须用 tag 批量清理

不是所有“一批数据”都需要 tag；只有当多个 key 逻辑归属同一业务维度、且生命周期一致、又需要原子性清理时，tag 才有价值。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

典型例子：

用户 ID 为 1001 的全部缓存（头像、资料、权限、通知未读数）——统一打 tag('user_1001')，用户登出或资料更新时一键清空
某个栏目（如 'tech'）下的文章列表、分页总数、热门标签 —— 打 tag('channel_tech')，栏目配置变更时批量失效
权限系统中，角色 'editor' 关联的所有接口白名单、菜单树、按钮权限 —— 清理该角色缓存时，不碰其他角色数据

反例：把所有“用户配置”都塞进 tag('config')，结果改一个开关就要清掉全部用户配置，得不偿失。

APCu + Redis 混合使用时 tag 的陷阱

如果你按前文配置了 APCu 作本地热点缓存、Redis 作分布式主缓存，千万别以为 Cache::store('redis')->tag('x')->clear() 能顺带清掉 APCu 里的同名 key——它完全不会。

两级缓存各自独立，tag 清理只作用于当前 store。这意味着：

你必须在业务代码里显式同步清理：Cache::store('apcu')->rm('user_1001_profile') + Cache::store('redis')->tag('user_1001')->clear()
封装一个 clearUserCache($uid) 方法是刚需，否则漏清 APCu 会导致脏数据长期存在
APCu 本身不支持 tag，所以只能靠约定 key 前缀（如 tp5_apcu_user_1001_*），再用 apcu_clear_cache() 全局清或自己遍历 apcu_sma_info() 筛选——不推荐

最稳的做法：APCu 只缓存绝对不变的数据（如地区字典），变的数据全交给 Redis + tag 管理，避免同步难题。