在 PHP 開發中,經常需要獲取伺服器的文檔根目錄、當前腳本的絕對路徑,以及完整的 URL 地址。這些資訊對於構建路徑、包含檔案、重導向等操作至關重要。以下整理了最常用的超全域變數與魔術常數,並說明其差異與適用場景。
$_SERVER['DOCUMENT_ROOT']返回 Web 伺服器配置文件中定義的文檔根目錄絕對路徑(例如 /var/www/html 或 C:/xampp/htdocs)。這是構建包含檔案路徑的基準點。
echo $_SERVER['DOCUMENT_ROOT'] . "<br>";
$_SERVER['PHP_SELF']返回當前執行腳本相對於文檔根目錄的路徑(例如 /project/index.php)。注意:此變數包含查詢字串之前的部分,常用於表單提交的 action 屬性。
echo $_SERVER['PHP_SELF'] . "<br>";
__FILE__魔術常數,返回當前檔案在檔案系統中的完整絕對路徑(含檔名),例如 /var/www/html/project/index.php。這在 include/require 時解析相對路徑極為可靠。
echo __FILE__ . "<br>";
dirname(__FILE__) 或 __DIR__ (PHP 5.3+)返回當前檔案所在目錄的絕對路徑(不含檔名)。推薦使用 __DIR__,語義更清晰且效能略高。
echo dirname(__FILE__); // 舊寫法
echo __DIR__; // PHP 5.3+ 推薦寫法
組合協定、主機名與腳本路徑即可得到完整 URL。若需包含查詢字串,請額外加上 $_SERVER['QUERY_STRING']。
$url_this = "https://" . $_SERVER['HTTP_HOST'] . $_SERVER['PHP_SELF'];
// 含查詢字串版本
$full_url = "https://" . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
實際部署時需考慮 HTTPS,建議封裝為函式:
function getCurrentUrl() {
$protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
return $protocol . '://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
}
DIRECTORY_SEPARATOR 可自動適配。__FILE__ 返回解析後的實體路徑,而 $_SERVER['PHP_SELF'] 可能保留符號連結路徑。$_SERVER['PHP_SELF'] 到 HTML 屬性時,務必經過 htmlspecialchars() 防止 XSS。