如何在 PHP 中实现局部页面缓存而不中断后续脚本执行-php教程-PHP中文网

如何在 PHP 中实现局部页面缓存而不中断后续脚本执行

本文介绍一种安全、可控的 php 页面片段缓存方案：仅缓存指定区域内容，避免使用 exit 导致后续 php 逻辑终止或 html 结构损坏，确保未缓存部分（如动态用户信息、实时表单）仍能正常执行与渲染。

本文介绍一种安全、可控的 php 页面片段缓存方案：仅缓存指定区域内容，避免使用 exit 导致后续 php 逻辑终止或 html 结构损坏，确保未缓存部分（如动态用户信息、实时表单）仍能正常执行与渲染。

在实际 PHP 开发中，简单全页缓存虽能提升性能，但常因粗暴使用 exit 或 die() 而破坏页面完整性——例如缓存命中后提前退出，导致页脚脚本、会话处理、JavaScript 初始化等关键逻辑被跳过，甚至造成 HTML 标签未闭合、DOM 结构断裂等问题。

正确的做法是将缓存逻辑视为“条件性内容插入”而非“流程拦截”。核心思想是：
✅ 缓存存在 → 直接输出缓存内容，不中断执行；
❌ 缓存失效/不存在 → 启动输出缓冲，捕获待缓存区内容，写入文件并原样输出；
➡️ 无论是否命中缓存，后续所有 PHP 代码（包括非缓存逻辑、数据库查询、模板渲染等）均照常运行。

以下是优化后的标准实现：

<?php // --- 缓存配置区 ---
$actual_link = $_SERVER['REQUEST_URI'];
$id = basename(parse_url($actual_link, PHP_URL_PATH)); // 更健壮地提取路径名（兼容带查询参数的 URI）
$cachefile = 'cache/cached-items/cached-' . $id . '-content.html';
$cachetime = 2419200; // 28 天（秒）

// --- 缓存读取与回退逻辑 ---
if (file_exists($cachefile) && (time() - $cachetime) < filemtime($cachefile)) {
    echo "<!-- Cached copy, generated " . date('Y-m-d H:i:s', filemtime($cachefile)) . " -->\n";
    readfile($cachefile); // 安全输出静态 HTML 片段
} else {
    ob_start(); // 仅在此分支开启缓冲

    // ✅ 此处放置「需要缓存」的动态 PHP 内容（如文章列表、商品推荐等）
    echo '<section class="featured-products">';
    // 示例：动态生成商品卡片
    for ($i = 1; $i Product #{$i} — Updated: " . date('H:i:s') . "";
    }
    echo '</section>';

    // ✅ 缓存写入：捕获并持久化当前缓冲内容
    $cached_content = ob_get_clean();
    file_put_contents($cachefile, $cached_content);
    echo $cached_content; // 立即输出，保持流式渲染一致性
}

// ⚠️ 以下代码「永不被跳过」：用户登录状态检查、实时通知、埋点脚本、页脚统计等
session_start();
$user_name = $_SESSION['name'] ?? 'Guest';
echo "<footer><p>Welcome, {$user_name} | Generated at " . date('H:i:s') . "</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill2138" title="PHP"><img
														src="https://img.php.cn/upload/skill/000/000/081/178884013267959.jpg" alt="PHP" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill2138" title="PHP" class="overflowclass">PHP</a>
													<p class="overflowclass">编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill2138" title="PHP" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div></footer>";
?>

关键改进说明：

移除 exit：用 if/else 分支替代流程强制终止，保障控制流完整；
精准缓冲范围：ob_start() 仅在缓存未命中时调用，避免对非缓存区域产生副作用；
安全文件名处理：使用 parse_url(..., PHP_URL_PATH) 防止 $_SERVER['REQUEST_URI'] 中的查询参数污染缓存键；
原子写入建议：生产环境可升级为 file_put_contents($cachefile, $content, LOCK_EX) 防止并发写冲突；
缓存清理机制：需配合后台任务或事件钩子（如文章更新时删除对应缓存文件），避免陈旧数据长期滞留。