萬盛學電腦網

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

PHP 預定義變數完整指南:超全域變數、伺服器變數與實戰應用

前言

PHP 提供了大量預定義變數,這些變數在腳本執行期間自動可用,無需手動定義。理解它們的用途、範圍與安全性差異,是撰寫安全、健壯 PHP 程式的基礎。本文系統整理所有核心預定義變數,並提供實戰範例與安全建議。

一、超全域變數(Superglobals)

超全域變數在所有作用域中自動可用,無需 global 關鍵字。PHP 4.1.0 起引入,取代舊式 $HTTP_*_VARS 陣列。

1. $GLOBALS — 所有全域變數的引用

<?php
$x = 10;
function test() {
    echo $GLOBALS['x']; // 輸出 10
    $GLOBALS['y'] = 20; // 定義全域變數
}
test();
echo $y; // 輸出 20
?>

2. $_SERVER — 伺服器與執行環境資訊

包含 HTTP 標頭、路徑、腳本位置等關鍵資訊。常用鍵名:

鍵名說明範例值
PHP_SELF當前執行腳本路徑(相對 Document Root)/index.php
REQUEST_METHOD請求方法GET, POST
HTTP_HOST請求的 Host 標頭example.com
HTTP_USER_AGENT瀏覽器 User-Agent 字串Mozilla/5.0...
REMOTE_ADDR客戶端 IP 位址192.168.1.100
SERVER_NAME伺服器主機名稱example.com
SERVER_ADDR伺服器 IP 位址10.0.0.5
REQUEST_URI請求 URI(含查詢字串)/search?q=php
QUERY_STRING查詢字串q=php
SCRIPT_FILENAME腳本絕對路徑/var/www/html/index.php
HTTPS是否為 HTTPS 請求on / off

3. $_GET — URL 查詢字串參數

透過 ?key=value 傳遞的資料。注意:資料可見於 URL,不適合敏感資訊,長度受限(約 2000 字元)。

4. $_POST — HTTP POST 請求主體資料

表單提交(application/x-www-form-urlencoded 或 multipart/form-data)的資料。適合敏感資料、大量資料、檔案上傳。

5. $_REQUEST — 合併 $_GET、$_POST、$_COOKIE

安全警告:順序由 variables_order (預設 GPC) 決定,同名鍵後者覆蓋前者。不建議使用,因無法區分資料來源,增加安全風險(如 CSRF、參數污染)。

6. $_COOKIE — HTTP Cookie 資料

客戶端送來的 Cookie。不可信任,用戶可竄改。敏感操作需驗證 Session 或簽名。

7. $_FILES — 檔案上傳資訊

<?php
// $_FILES['myfile'] 結構
[
    'name'     => 'photo.jpg',      // 原始檔名
    'type'     => 'image/jpeg',     // MIME 類型(瀏覽器提供,不可全信)
    'tmp_name' => '/tmp/phpX1234',  // 伺服器暫存路徑
    'error'    => 0,                // 錯誤代碼:0=成功, 1=超過 upload_max_filesize, 2=超過 MAX_FILE_SIZE, 3=部分上傳, 4=無檔案, 6=缺少暫存目錄, 7=寫入失敗
    'size'     => 123456            // 檔案大小(位元組)
]
?>

8. $_ENV — 環境變數

從系統環境變數取得(如 $_ENV['APP_ENV'])。需 php.ini variables_order 包含 E。

9. $_SESSION — Session 變數

需先呼叫 session_start()。資料儲存在伺服器端(預設檔案),客戶端僅保存 Session ID。適合儲存用戶登入狀態、購物車等敏感資料。

二、魔術常數(Magic Constants)

雖非變數,但常被歸類為預定義值,值會隨位置改變:

常數說明
__FILE__當前檔案完整路徑(含檔名)
__DIR__當前檔案所在目錄(PHP 5.3+)
__LINE__當前行號
__FUNCTION__函數名稱(區分大小寫)
__CLASS__類別名稱(含命名空間)
__TRAIT__Trait 名稱
__METHOD__類別方法名稱
__NAMESPACE__當前命名空間名稱

三、PHP 核心常數

<?php
echo PHP_VERSION;      // PHP 版本,如 8.2.12
echo PHP_OS;           // 作業系統,如 Linux
echo PHP_SAPI;         // Server API,如 fpm-fcgi, cli, apache2handler
echo PHP_INT_MAX;      // 整數最大值
echo PHP_EOL;          // 換行符號(跨平台)
echo DIRECTORY_SEPARATOR; // 目錄分隔符(Windows \,Linux /)
?>

四、安全最佳實踐

1. 永遠不信任外部輸入

$_GET、$_POST、$_REQUEST、$_COOKIE、$_FILES、$_SERVER(部分標頭如 HTTP_X_FORWARDED_FOR、HTTP_REFERER 可偽造)皆為不可信資料。

2. 使用過濾與驗證函數

<?php
// 取得整數 ID
$id = filter_input(INPUT_GET, 'id', FILTER_VALIDATE_INT);

// 取得 Email
$email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);

// 自定義過濾
$name = filter_input(INPUT_POST, 'name', FILTER_SANITIZE_STRING);
// PHP 8.1+ 建議使用 htmlspecialchars() 替代 FILTER_SANITIZE_STRING
$safe = htmlspecialchars($name, ENT_QUOTES, 'UTF-8');
?>

3. 避免使用 extract()、import_request_variables()

將陣列鍵匯入為變數極易造成變數覆蓋、安全漏洞。

4. 正確取得客戶端 IP

<?php
function getClientIp() {
    $keys = ['HTTP_CLIENT_IP', 'HTTP_X_FORWARDED_FOR', 'HTTP_X_FORWARDED', 'HTTP_X_CLUSTER_CLIENT_IP', 'HTTP_FORWARDED_FOR', 'HTTP_FORWARDED', 'REMOTE_ADDR'];
    foreach ($keys as $key) {
        if (!empty($_SERVER[$key])) {
            $ips = explode(',', $_SERVER[$key]);
            return trim($ips[0]);
        }
    }
    return 'unknown';
}
?>

五、命令列模式 (CLI) 差異

  • $_GET、$_POST、$_COOKIE、$_FILES、$_REQUEST 通常為空陣列
  • $_SERVER['argv']、$_SERVER['argc'] 提供命令列參數
  • $_SERVER['PHP_SELF']、$_SERVER['REQUEST_URI'] 等 Web 相關鍵可能不存在

總結

掌握 PHP 預定義變數的來源、範圍與安全性,是防禦 XSS、CSRF、SQL Injection 等攻擊的第一道防線。記住核心原則:所有外部輸入皆不可信,使用前必須過濾、驗證、轉義。

copyright © 萬盛學電腦網 all rights reserved