Yii3.0中启用视图布局需在config/web.php的view组件中配置'layout' => '@app/views/layouts/main.php'，并确保main.php包含$content占位符；否则页面空白且缓存失效。
在Yii3.0中启用视图布局并让页面结构统一
当你需要所有页面共享页头、导航栏和页脚，又不想在每个视图里重复写HTML时，就必须配置一个全局布局文件——这一步不做，后续所有缓存优化都建立在碎片化结构上，无法稳定生效。
打开项目根目录下的 config/web.php，在 ['components']['view'] 配置项中加入 'layout' => '@app/views/layouts/main.php'。注意路径必须用别名（@app），不能写相对路径或绝对路径，否则运行时报错且无明确提示。
创建文件 views/layouts/main.php，内容至少包含 = $content ?> 占位符；这是整个布局能渲染子视图的唯一入口，漏掉它，所有页面将只显示空白。
这一步操作起来很简单，直接把文件拖进去就行。但如果你跳过 layout 配置而直接写片段缓存，缓存内容会脱离上下文渲染，比如 CSS 样式丢失、JS 初始化失败——因为缓存只包裹了局部 HTML 片段，不感知外层结构。
为视图片段添加缓存：三步锁定高频变动区域
首页商品列表每秒被请求上百次，但库存数据仅每5分钟更新一次，此时对列表区域做片段缓存，可将 PHP 渲染耗时从 86ms 降至 4ms 左右。
第一步：确认缓存组件已启用。检查 config/web.php 中 ['components']['cache'] 是否存在且类为 yii\redis\Cache 或 yii\caching\FileCache；若仍用 CFileCache（Yii2写法），运行时会抛出 Class not found 异常。
第二步：在视图文件（如 views/site/index.php）中，用 beginCache() 和 endCache() 包裹待缓存的 HTML 块。必须成对出现，且中间不能有 PHP 语法错误，否则整个页面白屏。
第三步：传入缓存键与选项。例如：if ($this->beginCache('homepage-product-list', ['duration' => 300])) { —— 这里 300 表示缓存有效期为 5 分钟，单位是秒，不是毫秒，设错会导致缓存瞬间失效或永久不更新。
控制缓存刷新时机：依赖数据库变更自动失效
当商品价格在后台修改后，首页缓存必须立刻失效，否则用户看到的是旧价格。靠手动清缓存或固定时间过期都不够精准，要用数据库依赖机制。
方法一：使用 CDbCacheDependency（仅限 Yii2 兼容层）
不推荐。Yii3.0 已移除该类，强行使用会触发 Fatal error: Class 'CDbCacheDependency' not found。
方法二：在缓存选项中配置 SQL 依赖（Yii3 原生支持）
在 beginCache() 的第二个参数数组中加入：'dependency' => new \yii\caching\DbDependency(['sql' => 'SELECT MAX(updated_at) FROM product'])。这个 SQL 必须返回单个标量值，且字段类型需为时间戳或整型，否则依赖判断永远为 false，缓存永不刷新。
方法三：基于模型事件手动触发失效
在 Product 模型的 afterSave() 方法末尾添加：\Yii::$app->cache->delete('homepage-product-list');。这一步要写在父类调用之后，否则事务未提交就删缓存，新数据查不到。
避免缓存污染：多参数路由下生成独立缓存副本
用户访问 /product/list?page=1&sort=price 和 /product/list?page=2&sort=name 应该命中不同缓存，否则第一页内容会错误地显示在第二页位置。
- 在
beginCache()第二个参数中添加'varyByRoute' => true，让框架自动提取当前路由参数； - 若只需区分部分参数（如只按 page 变化），改用
'varyByParam' => ['page']； - 切勿将敏感参数（如 user_id、token）写入 varyByParam，否则缓存键爆炸式增长，Redis 内存迅速打满。
这一步漏掉会导致缓存穿透：用户 A 看到用户 B 的订单列表，属于严重数据越权问题。
验证缓存是否真正生效
打开浏览器开发者工具 → Network 标签页，刷新页面，找到对应 HTML 请求，查看响应头中是否有 X-Yii-Cache: HIT；若为 MISS，说明缓存未命中，需检查缓存组件是否启用、键名是否拼写一致、duration 是否设为 0。
在终端执行：php yii cache/flush-all，再刷新页面，若首次响应变慢且后续变快，证明缓存链路通了。
不要依赖日志判断——Yii3 默认关闭缓存日志，开启需额外配置 'enableLogging' => true 在 cache 组件中，否则看不到任何调试线索。
