萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

SSI #include 指令詳解:file 與 virtual 路徑差異、避坑與現代替代

SSI (Server Side Includes) 是伺服器端包含文件的指令,**僅在啟用 SSI 的伺服器(配置 .shtml/.shtm/.stm 或映射)生效**,純靜態 HTML 直接打開無效。

語法

<!-- #include file="relative/path.inc" -->
<!-- #include virtual="/absolute/from/root.inc" -->

file vs virtual 核心差異

類型路徑基準能否跨目錄能否跨虛擬目錄/站點
file當前文檔所在目錄可引用子目錄,不可引用父目錄 (../)否
virtualWeb 站點根目錄 (虛擬目錄根)可引用任意站內路徑同一站點不同虛擬目錄可互引

實例場景

<!-- 同目錄 -->
<!-- #include file="header.inc" -->

<!-- 虛擬目錄 /scripts/tools/ -->
<!-- #include virtual="/scripts/tools/global.inc" -->

<!-- 站點 A 引用站點 B (同 IIS 站點不同虛擬目錄) -->
<!-- #include virtual="/siteB/common/foot.inc" -->  <!-- 正確 -->
<!-- #include file="../siteB/common/foot.inc" -->  <!-- 錯誤:file 不允許 ../ -->

常見坑點

  1. 副檔名未映射 SSI 處理器 → 指令原文輸出到瀏覽器。
  2. 被包含文件建議用 .inc 後綴,並配置拒絕直接訪問(防洩露)。
  3. 路徑分隔符 / 或 \ 均可,但建議統一 /。
  4. 跨 **不同 IIS 站點** 無法用 SSI,需用 HTTP 子請求或模板引擎組裝。

現代替代方案

  • 模板引擎:EJS、Nunjucks、Handlebars(構建時/運行時渲染)。
  • SSG:Next.js getStaticProps、Astro 組件組合。
  • 邊緣計算:Cloudflare Workers HTMLRewriter、Vercel Edge Middleware 實現邊緣 SSI。
  • 前端組件化:Web Components、React/Vue/Svelte 組件取代服務端包含。

SSI 仍在舊系統、極簡靜態站、邊緣注入場景有價值,新專案建議遷移至現代方案。

copyright © 萬盛學電腦網 all rights reserved