雖然標題含「PHP」,但內容實為 JSP(JavaServer Pages)的兩種包含機制比較。此處整理為清晰對照表,供 Java Web 開發者參考。
| 比較項目 | include 指令 <%@ include file="..." %> | include 動作 <jsp:include page="..." /> |
|---|---|---|
| 處理階段 | 編譯期(翻譯階段)合併為單一 Servlet | 請求期(執行階段)動態包含 |
| 輸出內容 | 靜態文本或動態生成的輸出結果均可包含 | 僅包含目標頁面的輸出結果(響應體) |
| 變數共享 | 共享區域變數,宣告的腳本變數在所有組成頁面有效 | 不共享區域變數,需透過 request/session/application 傳遞 |
| 修改生效 | 被包含檔修改不立即生效,需修改主頁或刪除編譯類 | 修改被包含檔立即生效 |
| 變數衝突 | 需注意變數命名衝突 | 無衝突問題(各自獨立區域變數) |
| 適用場景 | 靜態頁首/尾、通用工具函數、不常變動的片段 | 動態內容、頻繁變更的模組、需隔離變數作用域 |
<%@ page language="java" contentType="text/html; charset=UTF-8" %>
<%@ include file="/common/header.jsp" %>
<h1>主頁內容</h1>
<%@ include file="/common/footer.jsp" %>
<jsp:include page="/dynamic/menu.jsp">
<jsp:param name="category" value="news" />
</jsp:include>
<jsp:include> 搭配 <jsp:param>。