PHP局部HTML缓存需用ob_start()配合回调函数截取并处理输出，推荐APCu内存缓存（apcu_store/apcu_exists），注意缓存键含上下文、避免未渲染PHP代码入缓存、函数封装比include嵌套更可靠。
用 ob_start() + 回调捕获 HTML 片段
PHP 没有内置“局部缓存”机制，得靠输出缓冲（Output Buffering）手动截取一段 HTML，再配合文件或 Redis 存储。核心是 ob_start() 启动缓冲，然后用回调函数处理内容——不是直接 echo，而是先判断缓存是否存在，存在就返回缓存，否则生成并写入缓存。
常见错误是只调用 ob_start() 却没配 ob_get_clean() 或 ob_end_flush()，导致页面空白或重复输出。
- 缓存键建议包含模板名、关键参数（如
$user_id）、版本号，避免混淆："sidebar_{$user_id}_v2" - 回调函数必须返回字符串，不能 echo；否则会触发“headers already sent”错误
- 若用文件缓存，注意
file_put_contents()的权限和并发写入问题，加LOCK_EX更稳妥
用 apcu_store() 缓存渲染结果（推荐 APCu）
APCu 是 PHP 7+ 最轻量的用户态内存缓存，适合存小段 HTML 字符串。比文件 I/O 快一个数量级，且无需序列化反序列化（serialize() 会拖慢速度）。
注意：APCu 是进程级缓存，重启 PHP-FPM 后清空；不适合长期或跨服务器共享的场景。
立即学习“PHP免费学习笔记（深入）”；
- 存储时用
apcu_store(，$key,$html,$ttl)$ttl单位是秒，设为 0 表示永不过期（不推荐） - 读取前务必用
apcu_exists(判断，不要依赖$key)apcu_fetch()返回false——它可能真存了false值 - HTML 中含动态时间、随机数等变量时，不能整个片段缓存，得拆出可缓存部分（比如只缓存用户头像和昵称，不缓存“在线状态”）
Redis 缓存片段时怎么处理 HTML 中的 PHP 变量？
Redis 本身只存字符串，没法执行 PHP 代码。所以“缓存片段”本质是缓存已渲染完成的 HTML 字符串，不是缓存模板+数据再运行。
这意味着：你必须在缓存前完成所有 include、foreach、date() 等逻辑，确保 $html 是纯 HTML 文本。
- 别把
这种未执行的 PHP 代码塞进 Redis——它不会被解释，只会原样输出 - 如果片段依赖当前请求上下文（如
$_SESSION['lang']），缓存键里必须包含该上下文哈希，例如："nav_" . md5($_SESSION['lang']) - 用
redis->setex(，避免$key,$ttl,$html)set + expire两步操作引发竞态
为什么 include 里套 ob_start() 容易出错？
很多开发者试图在 sidebar.php 文件开头写 ob_start()，结尾 ob_get_clean()，再 include 它——这看似干净，但实际埋雷。
问题在于：include 是语句，不是函数调用；ob_start() 的作用域受执行栈影响，嵌套 include 时缓冲可能意外关闭或覆盖。
- 更可靠的做法是把片段封装成函数，比如
render_sidebar($user)，函数内统一管理 ob 流程 - 避免在
if分支里条件性调用ob_start()，缓冲必须成对出现，否则ob_get_clean()会返回false并报 Notice - 调试时用
ob_get_level()查看当前缓冲嵌套层数，值为 0 表示没开启缓冲，值为 1 是正常，大于 1 就要小心是否漏关
