萬盛學電腦網

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

PHP 預定義超全域變數完整參考手冊

前言

PHP 提供 9 個「超全域變數」,在所有作用域自動可用,無需 global 宣告。它們承載 HTTP 請求、伺服器環境、會話狀態等關鍵資訊,是 Web 開發的核心資料來源。本文系統整理每個變數的結構、常用鍵值、安全注意事項與實戰範例。

一、$_SERVER — 伺服器與執行環境資訊

包含 HTTP 標頭、路徑、腳本位置等 CGI/Apache 變數。注意:鍵名大小寫不一致視伺服器而定,建議統一用 strtoupper 或 array_change_key_case。

常用鍵值速查

鍵名說明範例值
SERVER_ADDR伺服器 IP192.168.1.100
SERVER_NAME伺服器主機名example.com
REQUEST_METHOD請求方法GET, POST, PUT, DELETE
REMOTE_ADDR客戶端 IP (可能經代理)203.0.113.45
REMOTE_HOST客戶端主機名 (需 DNS 反解)user.isp.net
REMOTE_PORT客戶端連接埠54321
SCRIPT_FILENAME當前腳本絕對路徑/var/www/html/index.php
SERVER_PORT伺服器監聽埠80, 443
SERVER_SIGNATURE伺服器版本與虛擬主機資訊 (Apache)Apache/2.4.41 (Ubuntu)
DOCUMENT_ROOT網站根目錄/var/www/html
HTTP_USER_AGENT瀏覽器 UA 字串Mozilla/5.0...
HTTP_REFERER來源頁面 (不可信,可偽造)https://google.com/
REQUEST_URI請求 URI (含查詢字串)/search?q=php
QUERY_STRING查詢字串q=php&page=2
PHP_SELF當前腳本相對 DocumentRoot 路徑/index.php
REQUEST_TIME_FLOAT請求開始微秒時間戳 (PHP 5.4+)1699900000.1234
REQUEST_TIME請求開始秒級時間戳1699900000

安全取得真實客戶端 IP

function getClientIp() {
  $keys = ['HTTP_X_FORWARDED_FOR', 'HTTP_X_REAL_IP', 'HTTP_CLIENT_IP', 'REMOTE_ADDR'];
  foreach ($keys as $key) {
    if (!empty($_SERVER[$key])) {
      $ips = explode(',', $_SERVER[$key]);
      return trim($ips[0]); // 取第一個非代理 IP
    }
  }
  return 'unknown';
}

二、$_GET — URL 查詢字串參數

  • 來源:?key=value&foo=bar
  • 自動 urldecode
  • 只讀:修改不影響後續請求
  • 長度限制:約 2000 字符 (瀏覽器/伺服器限制)

三、$_POST — HTTP POST 主體資料

  • Content-Type: application/x-www-form-urlencoded 或 multipart/form-data
  • 上傳檔案資訊在 $_FILES,不在 $_POST
  • 最大尺寸受 post_max_size、upload_max_filesize 限制

四、$_COOKIE — HTTP Cookie

  • 由 setcookie() 設定,瀏覽器自動攜帶
  • 僅包含名稱/值,無過期時間、路徑、域等屬性
  • 安全旗標:setcookie('name', 'val', ['secure' => true, 'httponly' => true, 'samesite' => 'Lax'])

五、$_SESSION — 會話資料

  • 需先 session_start()
  • 資料儲存在伺服器 (預設檔案),客戶端僅存 Session ID
  • 常用設定:session.cookie_httponly=1, session.use_strict_mode=1, session.cookie_samesite=Lax
  • 分散式部署需共享 Session 存儲 (Redis/Memcached/DB)

六、$_FILES — 上傳檔案資訊

$_FILES['fieldName'] = [
  'name'     => 'original.jpg',   // 客戶端檔名
  'type'     => 'image/jpeg',     // MIME (不可信,需伺服端驗證)
  'tmp_name' => '/tmp/phpXyz123', // 臨時儲存路徑 (需 move_uploaded_file)
  'error'    => UPLOAD_ERR_OK,    // 錯誤代碼
  'size'     => 123456,           // 位元組數
];

錯誤代碼對照:UPLOAD_ERR_OK=0, UPLOAD_ERR_INI_SIZE=1, UPLOAD_ERR_FORM_SIZE=2, UPLOAD_ERR_PARTIAL=3, UPLOAD_ERR_NO_FILE=4, UPLOAD_ERR_NO_TMP_DIR=6, UPLOAD_ERR_CANT_WRITE=7, UPLOAD_ERR_EXTENSION=8。

七、$_ENV — 環境變數

  • 來源:Shell 環境、.env (透過 vlucas/phpdotenv)、Docker -e、K8s ConfigMap
  • 建議:敏感配置 (DB 密鑰、API Key) 僅從 $_ENV 讀取,勿硬編碼。

八、$_REQUEST — 合併 GET/POST/COOKIE (不推薦)

順序受 request_order (PHP.INI) 控制,預設 GP (GET 後 POST 覆蓋)。安全風險:Cookie 可覆蓋 GET/POST 參數,導致參數注入。明確使用 $_GET/$_POST/$_COOKIE。

九、$GLOBALS — 所有全域變數陣列

  • $GLOBALS['var'] === $var 在全域作用域
  • 包含所有超全域變數、使用者定義全域變數
  • 函式內可用 $GLOBALS['db'] 存取全域連線物件 (不推薦,優先依賴注入)

十、安全最佳實踐清單

  1. 永不信任 $_SERVER['HTTP_*'], $_GET, $_POST, $_COOKIE, $_REQUEST — 輸入必須驗證、過濾、轉義。
  2. 輸出編碼:HTML 用 htmlspecialchars($str, ENT_QUOTES, 'UTF-8'),JS 用 json_encode,SQL 用參數化查詢。
  3. 關閉危險功能:register_globals=Off (PHP 5.4+ 已移除)、allow_url_include=Off。
  4. 限制檔案上傳:驗證 MIME、副檔名、檔案頭、禁用執行權限、儲存於非 Web 可訪問目錄。
  5. Session 安全:session_regenerate_id(true) 登入後重新生成 ID,設定 cookie_secure (HTTPS)、cookie_httponly、cookie_samesite。

結語

熟練掌握 9 大超全域變數的來源、結構與安全邊界,是 PHP 開發者從「寫出能跑的代碼」進階到「寫出安全、可維護的應用」的關鍵門檻。建議收藏本表,開發時隨查隨用。

copyright © 萬盛學電腦網 all rights reserved