HTML模块化开发中基于SSI的低成本组装方案-html教程-PHP中文网

直接用ssi实现html模块化可行但需服务器端解析，浏览器不处理；apache需启用mod_include、注册.shtm类型并开放目录权限；nginx需显式配置ssi on和ssi_types；tomcat需privileged=true且完整注册ssiservlet；ssi存在本地无法预览、不支持传参、样式无隔离、无热更新等开发体验缺陷。

html模块化开发中基于ssi的低成本组装方案

直接用 SSI 实现 HTML 模块化是可行的，但必须满足服务器端解析条件——浏览器本身完全不处理 ，它只是注释；没配好 SSI 的服务器会原样返回这条注释，页面里就什么也不显示。

Apache 中 SSI 必须打开 mod_include 并设置 .shtml 类型

很多开发者以为改了 httpd.conf 就完事，结果页面空白。核心漏点是：mod_include 模块未启用 + 文件类型未注册 + 目录权限未放开。

LoadModule include_module modules/mod_include.so 这行必须取消注释（Windows 下路径可能含 so 或 dll）
AddType text/html .shtml 和 AddOutputFilter INCLUDES .shtml 缺一不可；若想让 .html 也生效，得加 AddOutputFilter INCLUDES .html，但会拖慢所有 HTML 响应速度
Options +Includes 要写在对应目录的 <directory></directory> 块里，不是全局配置就能生效；.htaccess 里加这句也行，但需确保 AllowOverride Options

Nginx 开启 SSI 需显式启用且注意 ssi_type

Nginx 默认关闭 SSI，且行为比 Apache 更严格：不设 ssi_types 就算开了 ssi on， 也不会被解析。

html-to-pptx

将多页 HTML 演示文稿转换为美化的 PPTX 文件，便于分享和分发。

下载

在 location 或 server 块中必须写：ssi on; + ssi_types text/html;
ssi_silent_errors off 推荐打开，否则包含失败时页面静默丢内容，极难排查
 中的 file 是相对当前文件路径的，不能跨出 document root；virtual 才支持绝对路径（如 /includes/footer.html）

Tomcat 配置 SSI 容易卡在 privileged 和 servlet 注册

Tomcat 的 SSI 支持是可选组件，7+ 版本默认不启用，且需要两处关键配置联动，缺一不可。

context.xml 中的 <context privileged="true"></context> 必须存在，否则 SSIServlet 不会被加载
web.xml 中的 <servlet></servlet> 和 <servlet-mapping></servlet-mapping> 都要完整配置，尤其 <url-pattern>*.shtml</url-pattern> 这一行不能漏
SSI 文件扩展名必须是 .shtml（或你自定义的映射），Tomcat 不支持对 .html 自动触发 SSI 解析
中文路径或文件名需确认 inputEncoding 和 outputEncoding 均设为 UTF-8，否则 include 内容乱码