PHP 提供了大量預定義變數,這些變數在腳本執行期間自動可用,無需手動定義。理解它們的用途、範圍與安全性差異,是撰寫安全、健壯 PHP 程式的基礎。本文系統整理所有核心預定義變數,並提供實戰範例與安全建議。
超全域變數在所有作用域中自動可用,無需 global 關鍵字。PHP 4.1.0 起引入,取代舊式 $HTTP_*_VARS 陣列。
<?php
$x = 10;
function test() {
echo $GLOBALS['x']; // 輸出 10
$GLOBALS['y'] = 20; // 定義全域變數
}
test();
echo $y; // 輸出 20
?>
包含 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 |
透過 ?key=value 傳遞的資料。注意:資料可見於 URL,不適合敏感資訊,長度受限(約 2000 字元)。
表單提交(application/x-www-form-urlencoded 或 multipart/form-data)的資料。適合敏感資料、大量資料、檔案上傳。
安全警告:順序由 variables_order (預設 GPC) 決定,同名鍵後者覆蓋前者。不建議使用,因無法區分資料來源,增加安全風險(如 CSRF、參數污染)。
客戶端送來的 Cookie。不可信任,用戶可竄改。敏感操作需驗證 Session 或簽名。
<?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 // 檔案大小(位元組)
]
?>
從系統環境變數取得(如 $_ENV['APP_ENV'])。需 php.ini variables_order 包含 E。
需先呼叫 session_start()。資料儲存在伺服器端(預設檔案),客戶端僅保存 Session ID。適合儲存用戶登入狀態、購物車等敏感資料。
雖非變數,但常被歸類為預定義值,值會隨位置改變:
| 常數 | 說明 |
|---|---|
__FILE__ | 當前檔案完整路徑(含檔名) |
__DIR__ | 當前檔案所在目錄(PHP 5.3+) |
__LINE__ | 當前行號 |
__FUNCTION__ | 函數名稱(區分大小寫) |
__CLASS__ | 類別名稱(含命名空間) |
__TRAIT__ | Trait 名稱 |
__METHOD__ | 類別方法名稱 |
__NAMESPACE__ | 當前命名空間名稱 |
<?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 /)
?>
$_GET、$_POST、$_REQUEST、$_COOKIE、$_FILES、$_SERVER(部分標頭如 HTTP_X_FORWARDED_FOR、HTTP_REFERER 可偽造)皆為不可信資料。
<?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');
?>
將陣列鍵匯入為變數極易造成變數覆蓋、安全漏洞。
<?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';
}
?>
$_GET、$_POST、$_COOKIE、$_FILES、$_REQUEST 通常為空陣列$_SERVER['argv']、$_SERVER['argc'] 提供命令列參數$_SERVER['PHP_SELF']、$_SERVER['REQUEST_URI'] 等 Web 相關鍵可能不存在掌握 PHP 預定義變數的來源、範圍與安全性,是防禦 XSS、CSRF、SQL Injection 等攻擊的第一道防線。記住核心原則:所有外部輸入皆不可信,使用前必須過濾、驗證、轉義。