Yii2.0.54片段缓存依赖配置核心是“条件触发”失效:需显式传入yii\caching\Dependency子类实例(如DbDependency、FileDependency、ExpressionDependency或ChainedDependency),仅设duration无法响应实时变更。

Yii2.0.54 的片段缓存依赖配置,核心在于让缓存自动感知数据变化并及时失效——不是靠定时清理,而是靠“条件触发”。只要依赖项一变,对应缓存立刻不可用,下一次访问就会重新生成。关键不在缓存本身,而在依赖怎么写准、配对、生效。
依赖必须显式声明,不能只靠 duration
仅设 duration(如 3600 秒)只能控制缓存存活时长,无法响应实时变更。要实现“数据一改缓存即失”,必须传入 dependency 参数。它是一个对象,决定缓存是否还“可信”。
- 片段缓存中通过
$this->beginCache('key', ['dependency' => $dep])传入 - 数据缓存中通过
$cache->set($key, $value, $duration, $dep)或getOrSet()的第四个参数传入 - 依赖对象必须是
yii\caching\Dependency子类的实例,不能是数组或字符串
DbDependency:用 SQL 结果判断是否失效
适合监控数据库表内容变化,比如商品列表、文章总数、最新更新时间等。它不是监听数据库事件,而是在每次读缓存前重新执行一次 SQL,比对结果是否不同。
- SQL 必须返回单个标量值(一行一列),推荐用聚合函数:
SELECT MAX(updated_at) FROM {{%post}}或SELECT COUNT(*) FROM {{%user}} - 务必显式指定 db 组件(尤其多库场景):
['class' => 'yii\caching\DbDependency', 'sql' => $sql, 'db' => Yii::$app->get('db_main')] - 表名用
{{%table}}占位符,自动替换前缀,避免硬编码 - 不要在 SQL 中写动态 WHERE 条件(如
WHERE id = :id),因为依赖对象复用,参数不会自动刷新
FileDependency 和 ExpressionDependency:轻量灵活的选择
适合不涉及数据库、但需响应外部变化的场景。
-
FileDependency:监控文件修改时间。例如配置文件、模板片段、静态数据 JSON。
new \yii\caching\FileDependency(['fileName' => '@app/config/params-local.php']) -
ExpressionDependency:执行一段 PHP 表达式,结果变化则缓存失效。例如用户角色变更:
new \yii\caching\ExpressionDependency(['expression' => 'Yii::$app->user->identity->role === "admin"']) - 表达式里可安全使用
Yii::$app、$_GET、date('Ymd')等,但避免耗时操作或副作用代码
组合依赖:多个条件同时满足才命中
从 Yii 2.0.14 起支持 ChainedDependency(链式依赖),任意一个子依赖变化,整个缓存就失效,逻辑是“或”关系。
- 典型组合:数据库变动 + 当前语言变化:
new \yii\caching\ChainedDependency(['dependencies' => [$dbDep, $langDep]]) - 也可以嵌套使用,比如 DbDependency 内部再包一个 TagDependency,但可读性较差,建议优先用 ChainedDependency
- 注意:所有子依赖必须能独立实例化,且不互相干扰;若某依赖初始化失败(如 DB 连接断开),可能影响整个链路判断


















