无需修改文件扩展名，通过服务器配置使 .htm/.html 文件支持 php 解析，适用于无法更改后缀的静态页面场景。
无需修改文件扩展名，通过服务器配置使 .htm/.html 文件支持 php 解析，适用于无法更改后缀的静态页面场景。
在实际 Web 开发中，有时因历史原因、SEO 策略或 CMS 限制，必须保留 .htm 或 .html 后缀，但又需嵌入动态 PHP 逻辑（如包含公共头部、读取环境变量、调用数据库等）。此时，关键在于让 Web 服务器（如 Apache）将这些静态后缀识别为 PHP 脚本并交由 PHP 解释器处理。
✅ 正确配置方式（Apache）
.htaccess 是最常用的方法，但其生效依赖于服务器是否启用 AllowOverride 指令。常见错误配置包括：
- 重复或冲突的 AddHandler 指令（如同时写两行覆盖）；
- 错误的 MIME 类型或处理器名称（如 application/x-httpd-php74 在部分环境中不被识别）；
- .htaccess 未被允许解析（尤其在共享主机如 SiteGuard 上可能受限）。
推荐使用标准化、兼容性更强的配置：
# .htaccess 文件内容（置于网站根目录）
<IfModule mod_php7.c>
AddType application/x-httpd-php .html .htm
</IfModule>⚠️ 注意：
立即学习“PHP免费学习笔记（深入）”；
- AddType 比 AddHandler 更通用，且明确指定 MIME 类型，避免版本标识（如 php74）带来的兼容问题；
- 不要为同一后缀多次声明（如 .html 出现在两行中），否则可能导致解析失败；
- 确保 Apache 已加载 mod_php7 或对应模块（可通过 phpinfo() 或 a2enmod php7.4 验证）。
? 替代方案：虚拟主机配置（适用于有服务器权限时）
若 .htaccess 不生效（SiteGuard 等托管环境常禁用 AllowOverride All），需联系主机商或直接修改 Apache 虚拟主机配置（需 root 权限）：
# /etc/apache2/sites-enabled/your-site.conf 内的 <VirtualHost> 块中添加
<Directory "/var/www/html">
AllowOverride None # 若此处设为 None，则 .htaccess 将被忽略
Require all granted
</Directory>
# 在同一 <VirtualHost> 下添加：
AddType application/x-httpd-php .html .htm修改后务必重启 Apache：
sudo systemctl restart apache2
✅ 验证是否成功
创建测试文件 test.html：
<!DOCTYPE html>
<html>
<body>
<h1>PHP in HTML test</h1>
<p>Current time: <?php echo date('Y-m-d H:i:s'); ?></p>
<p>PHP version: <?php echo phpversion(); ?></p>
</body>
</html>访问 https://yoursite.com/test.html —— 若显示时间与 PHP 版本，则配置成功；若源码直接暴露，说明 PHP 未解析。
? SiteGuard 主机特别提示
SiteGuard 默认对 .htaccess 支持有限，且可能屏蔽 AddType/AddHandler 指令。建议：
- 登录 SiteGuard 控制面板，检查「PHP 设置」中是否开启「HTML 文件执行 PHP」选项；
- 提交工单确认是否支持 .htaccess 中的 AddType 指令；
- 若不可行，可考虑使用 <!--#include virtual="header.php" -->（SSI）作为轻量替代（需启用 mod_include）。
✅ 总结
| 方式 | 适用场景 | 注意事项 |
|---|---|---|
| .htaccess + AddType | 共享主机（支持 AllowOverride） | 使用 application/x-httpd-php，避免版本后缀 |
| 虚拟主机配置 | VPS/独立服务器 | 修改后必须重启 Apache |
| SSI 包含 | 极简需求（仅含引入） | 需启用 mod_include，性能略低于原生 PHP |
只要正确配置 MIME 类型映射，.htm 和 .html 完全可以无缝运行 PHP —— 关键不在文件名，而在服务器如何“看待”它。
