应使用支持标签的缓存驱动并执行针对性清理:一、Artisan命令php artisan cache:tags users clear;二、代码中Cache::tags(['users'])->flush();三、指定驱动Cache::store('redis')->tags(['notifications'])->flush();四、手动匹配键名前缀清除;五、封装自定义Artisan命令。

如果您在 Laravel 应用中为缓存项设置了标签(tags),但需要仅移除特定标签下的所有缓存条目而不影响其他缓存,则需使用支持标签的缓存驱动并执行针对性清理操作。以下是清除指定缓存标签内容的多种方法:
一、使用 Artisan 命令清除指定标签缓存
该命令适用于已启用标签支持的缓存驱动(如 file、redis、memcached),它会精准定位并删除所有绑定到指定标签的缓存项,不干扰其他标签或无标签缓存。
1、打开终端并进入 Laravel 项目根目录。
2、执行命令:php artisan cache:tags users clear,其中 users 为待清除的标签名。
3、若需清除多个标签,可重复执行该命令,分别指定不同标签名称。
二、在代码中调用 Cache::tags() 方法清除
此方式适用于控制器、命令类或服务中动态触发清除逻辑,允许在运行时根据条件构造标签名并执行清理,具备更高的灵活性和上下文感知能力。
1、在 PHP 文件中引入 Cache 门面:use Illuminate\Support\Facades\Cache;
2、调用带标签的 forget 操作:Cache::tags(['users', 'profile'])->flush();
3、若仅清除单个标签,可简化为:Cache::tags(['users'])->flush();
三、通过 Cache::store() 指定驱动后清除标签缓存
当应用配置了多个缓存存储器且仅需对某一个驱动(如 redis)执行标签清除时,必须显式指定 store,否则将默认作用于 config/cache.php 中设置的 default 驱动。
1、确认目标缓存驱动名称(例如 redis)已在 config/cache.php 的 stores 数组中定义。
2、执行带驱动选择的标签清除:Cache::store('redis')->tags(['notifications'])->flush();
3、该操作仅影响 redis 驱动中绑定 notifications 标签的所有缓存项。
四、手动遍历并逐个删除匹配标签的缓存键(兼容低版本或自定义驱动)
在部分缓存驱动(如 database 或 apc)不原生支持标签功能时,可借助缓存键命名规范(如前缀约定)模拟标签行为,并通过键名匹配实现逻辑清除。
1、确保缓存键采用统一前缀,例如:users:profile:123、users:settings:456。
2、使用 Cache::getKeys()(若驱动支持)或直接查询底层存储(如 Redis CLI 的 KEYS 命令)获取匹配 users:* 的全部键名。
3、对每个匹配键执行:Cache::forget($key);
五、创建自定义 Artisan 命令封装标签清除逻辑
为便于团队协作与部署脚本复用,可将多标签清除、驱动选择、异常处理等逻辑封装为独立命令,避免重复编写相同业务代码。
1、生成新命令:php artisan make:command ClearTaggedCache
2、在 handle() 方法中注入标签数组与驱动选项,调用 Cache::store($driver)->tags($tags)->flush()。
3、注册命令签名,例如:$this->signature = 'cache:clear-tags {tags*} {--driver=}',支持类似 php artisan cache:clear-tags users notifications --driver=redis 的调用方式。


















