萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 獲取專案根目錄絕對路徑:getRootPath() 函數實作與避坑指南

函數實作

/**
 * 獲取專案根目錄絕對路徑(含結尾斜線)
 * @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__); // 專案根目錄

常見陷阱

  1. $_SERVER['DOCUMENT_ROOT'] 指向 Web 根目錄,非專案根目錄(若 public 為 DocumentRoot)。
  2. Windows 路徑分隔符 \,建議統一用 DIRECTORY_SEPARATOR 或 /(PHP 支援正斜線)。
  3. 避免在函數內使用 __FILE__ 或 __DIR__,會返回函數所在文件路徑而非調用者。
copyright © 萬盛學電腦網 all rights reserved