如何在 HTML 页面中通过 PHP 正确引入外部头部与页脚文件-html教程-PHP中文网

如何在 HTML 页面中通过 PHP 正确引入外部头部与页脚文件

本文详解如何使用 PHP 的 include 或 include_once 在 .php 文件中动态插入统一的 header 和 footer，强调必须配合本地服务器运行、文件扩展名需为 .php，并提供完整可执行示例。

本文详解如何使用 php 的 `include` 或 `include_once` 在 `.php` 文件中动态插入统一的 header 和 footer，强调必须配合本地服务器运行、文件扩展名需为 `.php`，并提供完整可执行示例。

在构建多页面网站（如影院管理系统）时，为避免重复编写相同的导航栏、页眉页脚，推荐采用 PHP 的服务端包含机制——但需注意：纯 HTML 文件无法解析 PHP 代码，且标签并非标准 HTML 语法，浏览器会直接忽略它。

✅ 正确实现步骤

1. 文件命名与结构规范

所有含 PHP 包含逻辑的文件必须以 .php 为后缀（如 index.php、film-detail.php），而非 .html；
公共模块（header/footer）建议命名为 header.php 和 footer.php，内容仅保留对应 HTML 片段（无需重复等全局结构）。

⚠️ 示例修正：原 header.html 应重命名为 header.php，并移除外层、
、标签——只保留实际要复用的 DOM 结构：

<!-- header.php -->
<header class="header"><nav class="navigation-open"><div class="global container grid-x">
      <div class="logowrapper grid-x">
        <div class="logo-container">
          <a href="index.php">@@##@@</a>
        </div>
      </div>
      <!-- 其余导航菜单代码保持不变 -->
      <nav class="loginwrapper grid-x cell align-right">...</nav>
</div>
  </nav></header>

2. 在主页面中调用 PHP 包含

在 film-detail.php（或 index.php）中，将 PHP 包含语句置于

内期望插入的位置：



  <meta charset="utf-8"><title>Cate Cinema - Film Detail</title><link rel="stylesheet" href="../page_film/page_film.css"><!-- 字体与图标 CSS 链接保持不变 --><?php include_once './header/header.php'; ?><!-- ▼ 当前页面专属内容 ▼ --><main class="film-content"><h1>《奥本海默》剧情简介</h1>
    <p>导演：克里斯托弗·诺兰｜上映日期：2023年7月21日</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill9972" title="Wechat Article Html"><img
														src="https://img.php.cn/upload/skill/001/246/273/6adaf20e695c2374.jpg" alt="Wechat Article Html" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill9972" title="Wechat Article Html" class="overflowclass">Wechat Article Html</a>
													<p class="overflowclass">将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill9972" title="Wechat Article Html" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>
    <!-- 其他影片详情 -->
  </main><?php include_once './footer/footer.php'; ?>

3. 必须运行于本地服务器环境

PHP 代码无法通过双击 .php 文件或直接用浏览器打开 file:// 协议执行。你必须：

安装轻量级本地服务器套件（如 XAMPP、MAMP 或 VS Code 的 Live Server 扩展 + PHP Server）；
将项目放入服务器根目录（如 xampp/htdocs/cinema/）；
启动 Apache 服务，并通过 http://localhost/cinema/film-detail.php 访问。

4. 路径注意事项

include_once 使用相对路径（相对于当前 .php 文件位置）；
推荐使用 ./ 开头明确当前目录，避免因工作目录变化导致路径错误；
若文件层级较深，可用 __DIR__ . '/path/to/header.php' 提升可靠性：

<?php include_once __DIR__ . '/../shared/header.php'; ?>

? 补充说明

include_once vs include：前者确保同一文件仅被包含一次，防止重复定义函数/类引发致命错误，生产环境强烈推荐；
替代方案提醒：若暂无法部署 PHP 环境，可考虑前端方案（如 Web Components + import() 动态加载、或构建工具如 Vite + HTML 插件），但 PHP 包含是服务端最简洁、兼容性最佳的方案；
安全性提示：切勿在 include 中使用用户可控变量（如 $_GET['file']），否则可能导致远程文件包含（RFI）漏洞。

通过以上配置，你即可实现影院网站所有影片页共享同一套响应式头部与页脚，大幅提升开发效率与后期维护性。