萬盛學電腦網

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

PHP 獲取網頁文檔路徑與當前 URL 完整指南

PHP 獲取伺服器路徑與當前網址的核心方法

在 PHP 開發中,經常需要獲取伺服器的文檔根目錄、當前腳本的絕對路徑,以及完整的 URL 地址。這些資訊對於構建路徑、包含檔案、重導向等操作至關重要。以下整理了最常用的超全域變數與魔術常數,並說明其差異與適用場景。

1. 伺服器文檔根目錄:$_SERVER['DOCUMENT_ROOT']

返回 Web 伺服器配置文件中定義的文檔根目錄絕對路徑(例如 /var/www/html 或 C:/xampp/htdocs)。這是構建包含檔案路徑的基準點。

echo $_SERVER['DOCUMENT_ROOT'] . "<br>";

2. 當前執行腳本的伺服器絕對路徑:$_SERVER['PHP_SELF']

返回當前執行腳本相對於文檔根目錄的路徑(例如 /project/index.php)。注意:此變數包含查詢字串之前的部分,常用於表單提交的 action 屬性。

echo $_SERVER['PHP_SELF'] . "<br>";

3. 當前檔案的檔案系統絕對路徑:__FILE__

魔術常數,返回當前檔案在檔案系統中的完整絕對路徑(含檔名),例如 /var/www/html/project/index.php。這在 include/require 時解析相對路徑極為可靠。

echo __FILE__ . "<br>";

4. 當前檔案所在目錄路徑:dirname(__FILE__) 或 __DIR__ (PHP 5.3+)

返回當前檔案所在目錄的絕對路徑(不含檔名)。推薦使用 __DIR__,語義更清晰且效能略高。

echo dirname(__FILE__); // 舊寫法
echo __DIR__;             // PHP 5.3+ 推薦寫法

5. 獲取完整的當前 URL

組合協定、主機名與腳本路徑即可得到完整 URL。若需包含查詢字串,請額外加上 $_SERVER['QUERY_STRING']。

$url_this = "https://" . $_SERVER['HTTP_HOST'] . $_SERVER['PHP_SELF'];
// 含查詢字串版本
$full_url = "https://" . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];

補充:HTTPS 環境下的協定判斷

實際部署時需考慮 HTTPS,建議封裝為函式:

function getCurrentUrl() {
    $protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
    return $protocol . '://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
}

常見陷阱與最佳實踐

  • 路徑分隔符:Windows 使用反斜線,Linux/Unix 使用正斜線。PHP 內建常數 DIRECTORY_SEPARATOR 可自動適配。
  • 符號連結:__FILE__ 返回解析後的實體路徑,而 $_SERVER['PHP_SELF'] 可能保留符號連結路徑。
  • 安全性:直接輸出 $_SERVER['PHP_SELF'] 到 HTML 屬性時,務必經過 htmlspecialchars() 防止 XSS。
copyright © 萬盛學電腦網 all rights reserved