PHP 的 include 或 include_once 语句无法在纯 .html 文件中生效，必须将页面保存为 .php 扩展名，并通过本地服务器（如 XAMPP）运行，才能正确解析和嵌入外部 PHP/HTML 片段。
php 的 `include` 或 `include_once` 语句无法在纯 `.html` 文件中生效，必须将页面保存为 `.php` 扩展名，并通过本地服务器（如 xampp）运行，才能正确解析和嵌入外部 php/html 片段。
在构建静态结构复用性强的网站（例如影院管理系统）时，将页眉（header）、页脚（footer）等公共部分抽离为独立文件，再动态插入各页面，是提升可维护性与开发效率的关键实践。但需注意：HTML 本身不支持 <include> 标签——该语法并不存在于任何 HTML 标准中，浏览器会直接忽略 <include src="..."> 等写法，导致内容完全不渲染。
要实现真正的服务端包含，必须依赖 PHP 的 include 或更安全的 include_once 语句，且需满足两个前提条件：
✅ 文件扩展名必须为 .php
即使文件内容主要是 HTML，也必须以 .php 结尾（如 index.php、movie-detail.php），否则 Web 服务器不会调用 PHP 解析器。
✅ 必须通过本地/远程 Web 服务器访问
直接双击打开 .php 文件（file:// 协议）时，PHP 代码不会执行。必须使用如 XAMPP、MAMP 或 VS Code 的 Live Server（需配合 PHP 插件）等工具启动本地服务器，并通过 http://localhost/your-site/index.php 访问。
✅ 正确实现步骤（以影院项目为例）
-
重命名并重构文件结构
将原 header.html 改为 header.php（无需 <html><head><body> 全局结构，仅保留复用片段）：<!-- ./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"><img class="logo" src="../img/logo.png" alt="Cate Cinema"></a> </div> </div> <!-- ... 其余导航菜单代码（保持原样） --> </div> </nav> </header> -
在主页面中调用（如 movie-detail.php）
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>Cate Cinema — Film Detail</title> <link rel="stylesheet" href="../page_film/page_film.css"> <!-- 字体与 Font Awesome 链接（同原 header.html 中的 head 部分） --> <link rel="stylesheet" href="https://use.fontawesome.com/releases/v6.4.0/css/all.css"> <link href="https://fonts.googleapis.com/css2?family=Ysabeau+Office:wght@500&display=swap" rel="stylesheet"> <!-- ... 其他字体 link --> </head> <body id="film-page"> <?php include_once './header.php'; ?> <!-- ▼ 唯一变化的主体内容 ▼ --> <main class="film-content"> <h1>《奥本海默》导演剪辑版</h1> <p>上映时间：2023年7月21日｜片长：180分钟｜语言：英语</p> <!-- 电影详情、购票按钮等 --> </main> <?php include_once './footer.php'; ?> </body> </html> -
创建 footer.php（同理精简）
立即学习“PHP免费学习笔记（深入）”；
<!-- ./footer.php --> <footer class="site-footer"> <p>© 2024 Cate Cinema. All rights reserved.</p> <nav> <a href="contact.php">联系我们</a> | <a href="privacy.php">隐私政策</a> </nav> </footer>
⚠️ 关键注意事项
- 路径问题：include_once 'path/to/file.php' 中的路径是相对于当前执行脚本的位置（非 HTML 中的 href 路径逻辑）。建议优先使用相对路径（如 ./header.php）或绝对路径常量（如 __DIR__ . '/includes/header.php'）提高健壮性。
- 避免重复包含：始终优先使用 include_once 或 require_once，防止因多次引入导致函数重定义错误。
- 不要混用 HTML 与 PHP 结构：header.php 中不应再写 <html>、<head> 等全局标签——它只是被“嵌入”的片段；完整 HTML 结构应由主 .php 文件统一控制。
- <link rel="import"> 已废弃：该 Web Components 特性已被移除标准，现代浏览器完全不支持，切勿使用。
通过以上方式，你不仅能高效复用页眉页脚，还能为后续添加动态功能（如用户登录状态判断、最新影片轮播等）预留清晰的 PHP 扩展接口。记住：PHP 是服务端技术，一切生效的前提是——让服务器跑起来。
