函數實作
/**
* 獲取專案根目錄絕對路徑(含結尾斜線)
* @return string
*/
function getRootPath(): string {
$realPath = realpath('./'); // 當前腳本所在目錄實際路徑
$selfPath = $_SERVER['PHP_SELF']; // 如 /project/public/index.php
$selfDir = substr($selfPath, 0, strrpos($selfPath, '/')); // /project/public
return substr($realPath, 0, strlen($realPath) - strlen($selfDir)) . '/';
}
原理圖解
假設:
realpath('./') = /var/www/project/public
$_SERVER['PHP_SELF'] = /project/public/index.php
strrpos('/', PHP_SELF) = 18 (/project/public)
selfDir = /project/public
realPath - selfDir = /var/www/project
返回 = /var/www/project/
適用場景與限制
- 入口文件在 public/ 目錄:返回專案根目錄(含 vendor、config 等)。
- CLI 模式:
$_SERVER['PHP_SELF'] 可能不存在或為腳本名,需改用 __DIR__。
- 符號鏈接:
realpath() 會解析鏈接,若需保留鏈接路徑請用 __DIR__ 手動拼接。
現代最佳實踐(PHP 5.3+)
// 入口文件 public/index.php 定義常數
define('ROOT_PATH', dirname(__DIR__, 2) . DIRECTORY_SEPARATOR); // 向上兩層
// 或使用 Composer 自動載入的 vendor/autoload.php 所在目錄
$root = dirname(__DIR__); // 專案根目錄
常見陷阱
$_SERVER['DOCUMENT_ROOT'] 指向 Web 根目錄,非專案根目錄(若 public 為 DocumentRoot)。
- Windows 路徑分隔符
\,建議統一用 DIRECTORY_SEPARATOR 或 /(PHP 支援正斜線)。
- 避免在函數內使用
__FILE__ 或 __DIR__,會返回函數所在文件路徑而非調用者。