讲师中心 微信公众号
AI工具推荐 视频效率加速

Yii框架的视图缓存怎么用_片段缓存和页面缓存配置【经验】

老宇同学_5665

老宇同学_5665

发布时间:2026-03-31 09:19:42

|

612人浏览过

|

来源于php中文网

原创

Yii视图片段缓存需配对使用beginCache()和endCache(),漏掉后者会导致页面截断;缓存键默认基于视图路径生成,支持dependency自动失效,duration设为0时依赖缓存组件TTL而非永不过期。

yii框架的视图缓存怎么用_片段缓存和页面缓存配置【经验】

视图里用 beginCache() 就能开片段缓存,但得配对调用 endCache()

Yii 的视图缓存核心就是 beginCache() 和 endCache() 这一对函数,不是配置开关、也不依赖控制器注解。漏掉 endCache() 会导致后续所有输出被吞掉——页面直接截断,连 HTML 结束标签都不见,浏览器里看源码会发现 </body> 后面啥也没有。

常见错误现象:500 错误没报,但页面下半截空白;或者控制台看到 ob_start(): failed to create buffer 类似提示(尤其在调试模式下)。

  • beginCache() 必须在视图文件(.php)里调用,不能放在布局或小部件里跨作用域使用
  • 缓存键默认由当前视图路径 + 参数生成,如果传了 ['dependency' => new \yii\caching\FileDependency(['fileName' => __FILE__])],改视图文件内容会自动失效缓存
  • 别在 beginCache() 区块里写 echo 或直接输出 HTML,要用 return 方式让内容进缓冲区(Yii 内部靠输出缓冲实现)

duration 参数不设默认是 0,意味着“永不过期”,但实际受缓存组件 TTL 限制

很多人以为 duration 是“必须填的”,其实不填或设为 0 时,Yii 会跳过时间判断,只依赖缓存依赖项(dependency)是否变化。但注意:底层用的 cache 组件(比如 redis 或 file)本身有最大存活时间(TTL),例如 Redis 默认 defaultDuration 是 3600 秒,这时候即使你代码里写 ['duration' => 0],缓存也最多活一小时。

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载
  • 显式设 duration => 600 表示 10 分钟后强制过期,不管依赖有没有变
  • 设 duration => 0 + dependency 是更安全的做法,适合模板内容随数据库/文件变化的场景
  • 如果用 apcu 缓存,注意它不支持 TTL,duration 实际无效,全靠 dependency 驱动刷新

页面级缓存得靠控制器行为(PageCache),不是视图函数

想整个 action 输出缓存?别在视图里折腾 beginCache(),那是片段级的。页面缓存必须在控制器里声明行为:PageCache。它拦截的是响应体生成前的整个流程,包括 layout 渲染,所以比视图缓存更彻底,但也更难调试。

  • PageCache 不执行控制器的 action 方法体,也不走 beforeAction,缓存命中就直接返回,这点和视图缓存完全不同
  • 缓存键默认含 GET 参数,但如果你加了 'variations' => ['Yii::$app->language'],多语言站点就不会混用缓存
  • POST 请求默认不缓存,但如果手动配了 'only' => ['index'] 又没限制 method,可能意外缓存 POST 响应(危险!)

缓存键里带用户信息?小心 Yii::$app->user->id 在未登录时是 null

片段缓存常要个性化,比如“我的订单列表”。直接写 ['key' => 'orders-' . Yii::$app->user->id] 看似合理,但游客访问时 Yii::$app->user->id 是 null,结果所有游客共用一个缓存键,互相看到对方空列表。这不是 bug,是预期行为——但容易被忽略。

  • 正确做法是先判断:$uid = Yii::$app->user->isGuest ? 'guest' : Yii::$app->user->id;
  • 如果用 dependency 关联用户数据表,记得查主键而非昵称等可变字段,否则更新昵称也会误刷缓存
  • Redis 中用 KEYS orders-* 能扫出缓存键,但生产环境禁用该命令,建议用 SCAN 替代,不然会卡住实例

缓存不是开个开关就完事,关键是理清“谁在读、谁在写、谁会变”。键设计、依赖粒度、组件选型这三块,错一个,缓存就从加速器变成定时雷。

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1678

2024.03.01

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4549

2023.11.02

内存数据库有哪些
内存数据库有哪些

内存数据库有Redis、Memcached、Apache Ignite、VoltDB、TimesTen、H2 Database、Aerospike、Oracle TimesTen In-Memory Database、SAP HANA和ache Cassandra。更多关于内存数据库相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4115

2023.11.14

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

7632

2024.04.02

redis怎么做缓存服务器
redis怎么做缓存服务器

redis 作为缓存服务器的答案:redis 是一款开源、高性能、分布式的键值存储,可作为缓存服务器使用。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

643

2024.04.07

redis怎么解决数据一致性
redis怎么解决数据一致性

redis 提供了两种一致性模型,以维护副本数据一致性:强一致性 (sync) 确保写操作仅在复制到所有从节点后才完成;最终一致性 (async) 则在主节点上写操作后认为已完成,牺牲一致性换取性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

756

2024.04.07

mysql和redis怎么保证双写一致性
mysql和redis怎么保证双写一致性

确保 mysql 和 redis 双写一致性的技术包括:1、事务性更新:同时更新 mysql 和 redis,保证一致性;2、主从复制:mysql 主服务器更改同步到 redis 从服务器;3、基于事件的更新:mysql 记录更改并发送到 redis等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

7582

2024.04.07

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

0

2026.10.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn