PHP 提供多種取得路徑的方式,初學者常混淆。本文彙整所有常用方法,附輸出範例與適用場景,建議收藏備查。
| 方法 | 回傳值說明 | 範例輸出 (假設專案在 G:/web,腳本在 G:/web/public/index.php) | 備註 |
|---|---|---|---|
__FILE__ | 目前檔案完整絕對路徑 (含檔名) | G:\web\public\index.php | 魔術常數,編譯時解析,不可變 |
__DIR__ | 目前檔案所在目錄 (無結尾斜線) | G:\web\public | PHP 5.3+,等同 dirname(__FILE__) |
dirname(__FILE__) | 同上 | G:\web\public | 舊版相容寫法 |
$_SERVER['PHP_SELF'] | 目前腳本的 URL 路徑 (相對 DocumentRoot) | /public/index.php | CGI 模式下與 SCRIPT_NAME 不同,現代極少見 |
$_SERVER['SCRIPT_NAME'] | 同上 (標準 CGI 變數) | /public/index.php | 推薦用此而非 PHP_SELF |
$_SERVER['SCRIPT_FILENAME'] | 目前執行腳本的絕對路徑 | G:\web\public\index.php | CLI 模式下不可用 |
$_SERVER['DOCUMENT_ROOT'] | Web 伺服器設定的文件根目錄 | G:\web | CLI 下為空,虛擬主機可能不準 |
getcwd() | 目前工作目錄 (進程概念) | G:\web\public (若在該目錄執行) | 可被 chdir() 改變,不等於腳本目錄 |
<?php
echo "__FILE__: ========> " . __FILE__ . "<br/>";
echo "__DIR__: ========> " . __DIR__ . "<br/>";
echo "dirname(__FILE__): ========> " . dirname(__FILE__) . "<br/>";
echo '$_SERVER["PHP_SELF"]: ========> ' . $_SERVER['PHP_SELF'] . "<br/>";
echo '$_SERVER["SCRIPT_NAME"]: ========> ' . $_SERVER['SCRIPT_NAME'] . "<br/>";
echo '$_SERVER["SCRIPT_FILENAME"]: ========> ' . $_SERVER['SCRIPT_FILENAME'] . "<br/>";
echo '$_SERVER["DOCUMENT_ROOT"]: ========> ' . $_SERVER['DOCUMENT_ROOT'] . "<br/>";
echo "getcwd(): ========> " . getcwd() . "<br/>";
__FILE__ 回傳被引入檔案的路徑,非主執行檔。需在入口檔定義 ROOT_PATH 傳遞。$_SERVER['DOCUMENT_ROOT']、SCRIPT_FILENAME、PHP_SELF 可能為空或異常,請改用 __DIR__ 或 getcwd()。realpath(__DIR__) 可解析真實路徑,避免連結導致的路徑不一致。DIRECTORY_SEPARATOR 常數或 str_replace('\\', '/', $path) 標準化為 /。// public/index.php (唯一入口)
define('ROOT_PATH', realpath(__DIR__ . '/../'));
define('APP_PATH', ROOT_PATH . '/app');
define('CONFIG_PATH', ROOT_PATH . '/config');
// ... 其他層路徑常數
// 所有檔案開頭
require_once __DIR__ . '/../bootstrap.php'; // 載入常數定義
統一由入口檔定義路徑常數,消除「到處寫 dirname」的維護地獄。