在 PHP 專案中使用 include 或 require 引入檔案時,若使用相對路徑,容易因「當前工作目錄」與「腳本所在目錄」不一致而導致找不到檔案。特別是多層目錄結構下,問題更為明顯。
/var/www/html/
├── b.php (根目錄同層)
├── a.php (根目錄)
├── c.php (根目錄)
└── dir/
└── d.php (子目錄)
dirname(__FILE__)(PHP 5.3+ 可用 __DIR__)核心原則:以「目前執行腳本的絕對路徑」為基準,構建目標檔案的絕對路徑。
<?php
// a.php
include_once dirname(__FILE__) . "/../b.php"; // 往上一層找 b.php
include_once dirname(__FILE__) . "/c.php"; // 同層 c.php
?>
<?php
// c.php
include_once dirname(__FILE__) . "/dir/d.php"; // 子目錄下的 d.php
?>
__FILE__ 永遠指向該腳本本身的絕對路徑。set_include_path():直接指定絕對路徑避免了 include_path 遍歷查找的開銷。<?php
// PHP 5.3+ 可直接使用魔術常數 __DIR__
include_once __DIR__ . "/../b.php";
include_once __DIR__ . "/dir/d.php";
?>
__DIR__ 等同於 dirname(__FILE__),但更簡潔、語意更明確。
index.php)定義 define('ROOT_PATH', __DIR__);,後續統一使用 ROOT_PATH . '/lib/xxx.php'。include 的需求。