PHP 專案中頻繁需要獲取腳本路徑、目錄、文檔根目錄等資訊。本文系統整理魔術常數(__FILE__、__DIR__)、$_SERVER 超全域陣列關鍵鍵值、以及 dirname()、basename()、realpath() 等路徑處理函數,並附上對照表與使用場景建議。
| 常數 | 說明 | 範例輸出 |
|---|---|---|
__FILE__ | 當前檔案完整絕對路徑(含檔名) | /var/www/html/index.php |
__DIR__ | 當前檔案所在目錄(PHP 5.3+),等同 dirname(__FILE__) | /var/www/html |
| 變數 | 說明 | 注意事項 |
|---|---|---|
$_SERVER['PHP_SELF'] | 當前執行腳本相對文檔根目錄的路徑 | /test/2005/test.php |
$_SERVER['SCRIPT_NAME'] | 同 PHP_SELF,CGI 模式下可能不同(現罕見) | 同上 |
$_SERVER['SCRIPT_FILENAME'] | 當前執行腳本絕對路徑(CLI 模式下不可用) | /var/www/html/test.php |
$_SERVER['DOCUMENT_ROOT'] | 文檔根目錄(Apache DocumentRoot / Nginx root) | /var/www/html |
$_SERVER['REQUEST_URI'] | 請求 URI(含查詢字串) | /test.php?id=1 |
$_SERVER['HTTP_HOST'] | 請求 Host 標頭 | example.com:8080 |
<?php
$path = "/var/www/html/test/file.php";
// 取得目錄部分
echo dirname($path); // /var/www/html/test
// 取得檔名部分
echo basename($path); // file.php
echo basename($path, '.php'); // file(移除副檔名)
// 取得規範化絕對路徑(解析 . 、.. 、符號連結)
echo realpath($path); // /var/www/html/test/file.php
// 取得當前工作目錄(CLI 下為執行目錄,Web 下通常同 DOCUMENT_ROOT)
echo getcwd(); // /var/www/html
?>
<?php
// 入口檔 public/index.php
define('APP_ROOT', dirname(__DIR__)); // 專案根目錄
define('PUBLIC_ROOT', __DIR__); // 公開目錄
?>
<?php
$file = $_GET['file'] ?? '';
$safePath = realpath(APP_ROOT . "/includes/$file.php");
if ($safePath && strpos($safePath, APP_ROOT) === 0) {
include $safePath;
} else {
die("Invalid file");
}
?>
$_SERVER['SCRIPT_FILENAME'] 可用,$_SERVER['DOCUMENT_ROOT'] 可能未設定$_SERVER['REQUEST_URI']、$_SERVER['HTTP_HOST'] 等僅 Web 環境有效__FILE__、__DIR__、getcwd() 兩者皆可用$_SERVER['PHP_SELF'] 直接輸出到 HTML(XSS 風險),需 htmlspecialchars()dirname(__FILE__) 在符號連結下可能返回連結目錄,realpath() 可解析真實路徑$HTTP_SERVER_VARS,已棄用,請改用 $_SERVER掌握這些路徑獲取方式,能讓專案部署遷移更順暢,路徑處理更安全可靠。