在 PHP 開發中,dirname(__FILE__) 是取得目前執行檔案所在目錄的常用寫法。__FILE__ 這個魔術常數會回傳目前檔案的完整路徑與檔名,若在被 include 的檔案中使用,則回傳被包含檔案的路徑。在 Windows 與 IIS 環境下鮮少出問題,但一旦部署到 Linux 伺服器,路徑解析差異就會導致 include 或 require 失敗。
近期在開發 WordPress 模板功能時,直接使用 include("檔名") 呼叫其他 PHP 片段,在 IIS 上運作正常,移至 Linux 後卻拋出路徑錯誤。經查證,Linux 下網站根目錄通常為 /home/web/,若程式寫 include("/檔名"),系統會去尋找 /home/web/檔名,而非預期的專案目錄下檔案,導致找不到檔案。
核心做法是以目前檔案位置為基準,動態組合目標路徑:
include dirname(__FILE__) . '/page.php';
這段碼要求被引用檔案與本檔案置於同一目錄。若需引用上一層目錄,可疊加使用:
dirname(dirname(__FILE__))
dirname(__FILE__)(PHP 5.3+ 可改用 __DIR__)建立絕對路徑,避免相對路徑在不同部署環境下失效。set_include_path() 或 Composer 自動載入機制,進一步統一專案路徑管理。掌握這項技巧,能有效消除跨平台部署時的路徑困擾,提升程式碼可移植性。