CakePHP 不支持原生片段缓存，$cacheAction 仅为全页缓存；需手动结合 Cache 类、ob_start() 和预设缓存配置实现局部缓存，且必须严格管理缓存键与主动失效。
CakePHP 没有原生的“片段缓存”机制——它不提供类似 Yii2 的 beginCache()/endCache() 或 Laravel 的 @cache 指令来包裹视图局部内容并单独设过期时间。 你看到的“view 缓存”或“部分 view 忽略”功能，本质是全页缓存（Full Page Cache）下的粗粒度控制，不是真正的局部片段缓存。
为什么 CakePHP 的 $cacheAction 不是片段缓存
它只作用于整个 action 的最终渲染输出，即：控制器执行完、布局+视图全部 render 完成后，把整页 HTML 存进缓存。即使你在视图里写了动态 PHP 代码（比如 date('Y-m-d')），只要该 action 被 $cacheAction 覆盖，那段代码就只会执行一次，后续请求直接返回缓存的静态 HTML —— 动态部分彻底失效。
常见错误现象包括：
- 用户登录状态栏显示上一个访客的名字
- 实时评论数始终卡在缓存生成时的值
- 使用
time()或rand()的区块完全不更新
这不是配置问题，而是设计限制：CakePHP 0.10.x 到 4.x 均未实现服务端视图层的局部缓存能力。
立即学习“PHP免费学习笔记（深入）”；
想实现局部缓存，只能绕过框架原生机制
你需要手动结合底层缓存组件（如 Cache 类）和视图逻辑，在 PHP 层做“缓存键拼接 → 尝试读取 → 未命中则渲染并写入”的闭环。关键点：
- 缓存键必须包含所有影响输出的变量，例如：
'article_summary_' . $articleId . '_' . $lang - 渲染逻辑必须封装成可调用的函数或闭包，不能依赖视图作用域里的隐式变量
- HTML 输出需用
ob_start()+ob_get_clean()捕获，再存入Cache::write() - 过期时间通过
Cache::write($key, $content, $config)的第三个参数传入，$config是缓存配置名（如'default'或'long'），其 TTL 在config/cache.php中定义
示例片段（放在视图文件中）：
<?php
$key = 'sidebar_popular_' . $category;
$content = Cache::read($key);
if ($content === false) {
ob_start();
// 这里放原本要缓存的视图代码，比如 foreach 循环渲染热门文章
echo $this->element('sidebar_popular', ['category' => $category]);
$content = ob_get_clean();
Cache::write($key, $content, 'short'); // 'short' 对应 config/cache.php 中定义的 300 秒 TTL
}
echo $content;
?>
cache.php 配置中的 TTL 是唯一可控出口
所谓“设置过期时间”，实际只发生在 config/cache.php 的配置组里，例如：
'short' => [
'className' => 'File',
'path' => CACHE . 'short' . DS,
'duration' => '300', // 单位：秒，不是字符串如 '5 minutes'
],
注意：
-
duration值必须是整数秒，不支持strtotime()字符串（那只是$cacheAction用的语法，和这里无关） - 不同缓存组（
'default','long','short'）对应不同 TTL，按业务敏感度划分 - 如果用了 Redis/Memcached 驱动，
duration会转为EXPIRE命令的实际秒数，行为一致
没有“某段 HTML 缓存 10 分钟，另一段缓存 2 小时”的声明式语法；一切靠你手写缓存键 + 手动调用 Cache::write() + 匹配预设配置组。
真正麻烦的不是写几行 Cache::read/write，而是确保缓存键覆盖所有上下文变量、并在数据变更时主动清除（比如文章更新后删掉所有含 $articleId 的键）。这点容易被忽略，导致缓存雪崩或陈旧内容长期滞留。
