ThinkPHP 模板引擎提供 <import>、<load> 兩個內建標籤,並支援原生 HTML <link>/<script>。本文整理各種引入方式與路徑規則。
<link rel="stylesheet" href="__PUBLIC__/Css/style.css" />
<script src="__PUBLIC__/Js/main.js"></script>
__PUBLIC__ 會自動編譯為網站公開目錄 URL。
<!-- 載入 Public/Js/test.js -->
<import type="js" file="Js.test">
<!-- 載入 Public/Css/test.css -->
<import type="css" file="Css.test">
<!-- 指定非 Public 目錄(basepath 相對網站根目錄) -->
<import type="css" file="Css.test" basepath="./Other" />
type:js 或 css,預設 jsfile:模組.檔名(不含副檔名),對應 Public/模組/檔名.副檔名basepath:自訂基礎路徑,尾部不加 /<load href="__PUBLIC__/Css/test.css" />
<load href="__PUBLIC__/Js/test.js" />
<link> 或 <script><load href="__PUBLIC__/Css/style.css?v={:C('APP_VERSION')}" />
| 方式 | 優點 | 缺點 |
|---|---|---|
| 原生 HTML | 通用、無框架綁定、IDE 提示完整 | 需手寫 __PUBLIC__ |
| import | 語意清晰、自動補全副檔名 | 僅限 Public 目錄結構、ThinkPHP 專用 |
| load | 最短、自動判斷類型 | ThinkPHP 專用、靜態分析工具可能不識別 |
現代專案建議**統一使用原生 HTML + 模板變數輸出版本號**;維護舊專案時依既有風格統一即可。