萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP dirname(__FILE__) 解決 Linux 環境下檔案引用路徑錯誤

前言:從 IIS 遷移到 Linux 遇到的路徑陷阱

在 PHP 開發中,dirname(__FILE__) 是取得目前執行檔案所在目錄的常用寫法。__FILE__ 這個魔術常數會回傳目前檔案的完整路徑與檔名,若在被 include 的檔案中使用,則回傳被包含檔案的路徑。在 Windows 與 IIS 環境下鮮少出問題,但一旦部署到 Linux 伺服器,路徑解析差異就會導致 include 或 require 失敗。

問題根源:Linux 站點根目錄與相對路徑的落差

近期在開發 WordPress 模板功能時,直接使用 include("檔名") 呼叫其他 PHP 片段,在 IIS 上運作正常,移至 Linux 後卻拋出路徑錯誤。經查證,Linux 下網站根目錄通常為 /home/web/,若程式寫 include("/檔名"),系統會去尋找 /home/web/檔名,而非預期的專案目錄下檔案,導致找不到檔案。

解決方案:以 dirname(__FILE__) 建立絕對路徑基準

核心做法是以目前檔案位置為基準,動態組合目標路徑:

include dirname(__FILE__) . '/page.php';

這段碼要求被引用檔案與本檔案置於同一目錄。若需引用上一層目錄,可疊加使用:

dirname(dirname(__FILE__))

最佳實踐建議

  • 撰寫 include/require 時,習慣使用 dirname(__FILE__)(PHP 5.3+ 可改用 __DIR__)建立絕對路徑,避免相對路徑在不同部署環境下失效。
  • 遷移伺服器後若出現檔案找不到錯誤,優先檢查引用路徑是否為硬編碼或相對路徑。
  • 搭配 set_include_path() 或 Composer 自動載入機制,進一步統一專案路徑管理。

掌握這項技巧,能有效消除跨平台部署時的路徑困擾,提升程式碼可移植性。

copyright © 萬盛學電腦網 all rights reserved