HOWTO · PHP

在 PHP 中獲取當前完整的 URL

本教程介紹瞭如何在 PHP 中獲取當前的 URL。

本頁內容

若要查看或組合目前這次 PHP 請求的網址,請將請求的通訊協定、主機和 URI 組合起來。這在依查詢參數呈現頁面或記錄請求網址時很有用。組合出的網址只是資料:若要用於重新導向,仍須另外判斷哪些目的地是允許的。

從請求資料組合目前網址

PHP 不會提供一個永遠代表完整目前網址的單一 $_SERVER 值。伺服器會提供各項請求資訊,應用程式再組合所需的部分。一般網頁請求的通訊協定是 http 或 https,主機可能包含連接埠,而請求 URI 則包含路徑和查詢字串。

從 $_SERVER 讀取通訊協定、主機和請求 URI

$_SERVER 是由網頁伺服器和執行環境填入的超全域陣列。$_SERVER['HTTP_HOST'] 提供請求中的主機,而 $_SERVER['REQUEST_URI'] 通常提供路徑和查詢字串。兩者單獨都不是完整網址。主機值來自傳入的請求,因此應將它視為不受信任的輸入:在重新導向或電子郵件中的絕對連結等安全敏感輸出中使用之前,請先依已知主機清單驗證。

處理 HTTPS 與代理伺服器環境

當 PHP 直接透過 TLS 接收請求時,$_SERVER['HTTPS'] 通常會設為 on 等非空值。選擇通訊協定前請檢查此值;不要假設所有伺服器的設定方式都相同。$_SERVER['REQUEST_SCHEME'] 也可能可用,但是否存在及其代表的意義取決於伺服器設定。

在反向代理部署中,瀏覽器可能透過 HTTPS 連線,而代理伺服器則透過 HTTP 連線到 PHP。此時,直接 HTTPS 值可能只反映代理伺服器到 PHP 之間的連線。只有在應用程式位於特別設定的受信任代理伺服器後方,而且該代理會移除或取代用戶端提供的同名標頭時,轉送的通訊協定標頭才可能有用。不要信任任意請求中的轉送標頭。請在代理伺服器和應用程式層設定信任關係,或使用伺服器能可靠提供的通訊協定資訊。

納入路徑和查詢字串

$_SERVER['REQUEST_URI'] 通常包含類似 /products.php?category=books&page=2 的值;將它附加上去,就會保留路徑和查詢字串。它不包含通訊協定或主機。查詢字串可能含有私人或敏感值,因此請考慮是否應將它寫入記錄、顯示在頁面上,或放進電子郵件網址。若未考量應用程式的路由方式和部署設定,請勿將請求 URI 直接視為標準網址。

選擇方法並確認結果

對於由網頁伺服器直接處理的一般請求,請明確組合伺服器提供的值。以下自足範例使用具代表性的請求值,方便說明組合方式;本撰寫階段尚未執行此範例:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

<?php
$_SERVER = [
    'HTTPS' => 'on',
    'HTTP_HOST' => 'shop.example.test',
    'REQUEST_URI' => '/products.php?category=books&page=2',
];

$isHttps = isset($_SERVER['HTTPS'])
    && $_SERVER['HTTPS'] !== ''
    && strtolower((string) $_SERVER['HTTPS']) !== 'off';
$scheme = $isHttps ? 'https' : 'http';
$host = $_SERVER['HTTP_HOST'];
$requestUri = $_SERVER['REQUEST_URI'];
$currentUrl = $scheme . '://' . $host . $requestUri;

echo $currentUrl, PHP_EOL;

結果字串由通訊協定、主機和請求 URI 組合而成。在你的應用程式中,請使用實際由請求提供的值,並確認網頁伺服器及任何受信任代理伺服器如何填入這些值。將結果用於重新導向前,請先驗證主機;組合出目前網址並不會讓任意重新導向目的地變得安全。