萬盛學電腦網

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

PHP $_SERVER 超全域變數完整手冊:HTTP、伺服器、路徑與安全應用

前言

$_SERVER 是 PHP 最重要的超全域陣列之一,包含 HTTP 請求、伺服器環境、腳本路徑等關鍵資訊。本文系統分類 40+ 常用鍵值,提供實戰範例與安全應用指南。

一、分類速查表

1. 請求與頁面相關

鍵名說明範例值
PHP_SELF當前腳本路徑 (相對 DocumentRoot)/index.php
SCRIPT_NAME同 PHP_SELF,但更標準/index.php
REQUEST_URI完整請求 URI (含查詢字串)/index.php?page=1&sort=desc
QUERY_STRING查詢字串 (不含 ?)page=1&sort=desc
REQUEST_METHODHTTP 方法GET, POST, PUT, DELETE
argv命令列參數陣列['arg1', 'arg2']
argc命令列參數個數2
REQUEST_TIME請求開始時間戳 (PHP 5.1+)1700000000
REQUEST_TIME_FLOAT微秒精度時間戳 (PHP 5.4+)1700000000.1234

2. HTTP 標頭資訊 (Client → Server)

鍵名對應 HTTP 標頭範例
HTTP_HOSTHostexample.com:8080
HTTP_REFERERRefererhttps://google.com/search?q=php
HTTP_USER_AGENTUser-AgentMozilla/5.0... Chrome/120
HTTP_ACCEPTAccepttext/html,application/xhtml+xml
HTTP_ACCEPT_LANGUAGEAccept-Languagezh-TW,zh;q=0.9,en;q=0.8
HTTP_ACCEPT_ENCODINGAccept-Encodinggzip, deflate, br
HTTP_ACCEPT_CHARSETAccept-Charsetutf-8, iso-8859-1
HTTP_CONNECTIONConnectionkeep-alive
HTTP_AUTHORIZATIONAuthorizationBearer xyz123
HTTP_COOKIECookiesession_id=abc; user=tom
HTTP_X_FORWARDED_FORX-Forwarded-For (代理)203.0.113.195, 70.41.3.18
HTTP_X_REAL_IPX-Real-IP (Nginx 代理)203.0.113.195

3. 伺服器與執行環境

鍵名說明範例
SERVER_SOFTWARE伺服器軟體版本nginx/1.24.0 / Apache/2.4.58
SERVER_NAME伺服器主機名 (VirtualHost)example.com
SERVER_ADDR伺服器 IP192.168.1.100
SERVER_PORT伺服器埠號80, 443, 8080
SERVER_PROTOCOLHTTP 協議版本HTTP/1.1, HTTP/2.0
SERVER_ADMIN管理員 Email (Apache 設定)admin@example.com
SERVER_SIGNATURE伺服器簽名 (錯誤頁面用)Apache/2.4.58 (Ubuntu) Server at...
GATEWAY_INTERFACECGI 規範版本CGI/1.1
DOCUMENT_ROOT網站根目錄絕對路徑/var/www/html
SCRIPT_FILENAME當前腳本絕對路徑/var/www/html/index.php
PATH_TRANSLATED檔案系統路徑 (非 DocumentRoot)/var/www/html/index.php

4. HTTPS 與認證

鍵名說明
HTTPS非空值表示 HTTPS (通常 'on')
SSL_TLS_SNISNI 主機名 (PHP 7.3+)
PHP_AUTH_USERHTTP Basic Auth 用戶名
PHP_AUTH_PWHTTP Basic Auth 密碼
PHP_AUTH_DIGESTHTTP Digest Auth 標頭內容
AUTH_TYPE認證類型 (Basic/Digest)

5. 客戶端資訊

鍵名說明
REMOTE_ADDR客戶端 IP (可能為代理 IP)
REMOTE_HOST客戶端主機名 (需 DNS 反解)
REMOTE_PORT客戶端來源埠號
REMOTE_USER經認證的用戶名 (Apache 模組)

二、關鍵差異辨析

PHP_SELF vs SCRIPT_NAME vs REQUEST_URI

// URL: https://example.com/index.php?foo=bar
$_SERVER['PHP_SELF']      = '/index.php';
$_SERVER['SCRIPT_NAME']   = '/index.php';
$_SERVER['REQUEST_URI']   = '/index.php?foo=bar';
$_SERVER['QUERY_STRING']  = 'foo=bar';

// 重寫規則下 (URL: https://example.com/user/profile)
$_SERVER['SCRIPT_NAME']   = '/index.php';      // 實際腳本
$_SERVER['REQUEST_URI']   = '/user/profile';   // 美化後 URL
$_SERVER['PHP_SELF']      = '/index.php';      // 同 SCRIPT_NAME

建議:表單 action 用 SCRIPT_NAME,重導向/生成連結用 REQUEST_URI。

取得真實客戶端 IP (反向代理環境)

function getClientIp(): string {
    $keys = [
        'HTTP_X_FORWARDED_FOR', // 可能包含多個 IP,取第一個
        'HTTP_X_REAL_IP',       // Nginx proxy_set_header
        'HTTP_CLIENT_IP',       // 部分代理
        'REMOTE_ADDR',          // 直連
    ];
    foreach ($keys as $key) {
        if (!empty($_SERVER[$key])) {
            $ips = explode(',', $_SERVER[$key]);
            return trim($ips[0]);
        }
    }
    return 'unknown';
}

三、安全應用指南

1. 防止 Host Header 攻擊

$allowedHosts = ['example.com', 'www.example.com'];
$host = $_SERVER['HTTP_HOST'] ?? $_SERVER['SERVER_NAME'];
if (!in_array($host, $allowedHosts, true)) {
    http_response_code(400);
    exit('Invalid Host header');
}

2. 安全重導向 (防開放重導向)

$redirect = $_GET['redirect'] ?? '/';
// 驗證同域或白名單
if (str_starts_with($redirect, '/') && !str_starts_with($redirect, '//')) {
    header("Location: $redirect");
    exit;
}

3. CSP Nonce 產生

$nonce = base64_encode(random_bytes(16));
header("Content-Security-Policy: script-src 'nonce-$nonce';");
// 模板中: 

4. CLI 環境下的 $_SERVER

CLI 模式下大多 HTTP_* 鍵不存在,REQUEST_METHOD 為空,argv/argc 可用。

四、實用工具函數

// 取得完整 URL
function getCurrentUrl(): string {
    $scheme = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
    $host = $_SERVER['HTTP_HOST'] ?? $_SERVER['SERVER_NAME'];
    $uri = $_SERVER['REQUEST_URI'] ?? '';
    return $scheme . '://' . $host . $uri;
}

// 判斷 AJAX 請求
function isAjax(): bool {
    return (isset($_SERVER['HTTP_X_REQUESTED_WITH']) 
        && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest');
}

// 判斷 HTTPS
function isHttps(): bool {
    return (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off')
        || ($_SERVER['SERVER_PORT'] ?? 80) === 443;
}

總結

$_SERVER 是 PHP 與 Web 伺服器溝通的橋樑。熟悉各鍵值含義、差異與安全風險,能編寫更健壯的路由、認證、日誌、防禦系統。記住:所有 HTTP_* 值皆來自用戶端,不可信任,必須驗證清洗後使用。

copyright © 萬盛學電腦網 all rights reserved