變數是 PHP 程式的基本構建塊。本文系統整理變數命名規則、定義方式、作用域規則、靜態變數、參考賦值機制、超全域變數與常見最佳實踐。
$ 開頭,後接字母或底線:$var, _var$var_name_123$var ≠ $Var ≠ $VARsnake_case($user_name)或 camelCase($userName)$this, $GLOBALS 等)$name = '張三';
$age = 25;
$price = 19.99;
$active = true;
// 全域常數(執行期定義)
define('APP_NAME', 'MyApp');
define('MAX_USERS', 1000);
// 類別常數(編譯期定義,可見性控制)
class Config {
public const VERSION = '1.0.0';
protected const DB_HOST = 'localhost';
private const API_KEY = 'secret';
}
echo APP_NAME; // MyApp
echo Config::VERSION; // 1.0.0
差異:define() 執行期定義、支援條件式定義、大小寫不敏感(第三參數);const 編譯期定義、必須在最上層、區分大小寫、可用於類別。
$a = 'hello';
$$a = 'world'; // 等同於 $hello = 'world';
echo "$a ${$a}"; // hello world
echo "$a $hello"; // hello world
// 陣列情況需消除歧義
$$a[1] // 歧義:${$a[1]} (取 $a[1] 做變數名) vs ${$a}[1] (取 $a 做變數名的陣列索引 1)
// 解決:${$a[1]} 或 ${$a}[1]
⚠️ 實務極少使用,降低可讀性,僅用於極特殊動態情境。
function counter() {
static $count = 0; // 僅初始化一次
$count++;
echo $count . "\n";
}
counter(); // 1
counter(); // 2
counter(); // 3
// 遞迴應用
function factorial(int $n): int {
static $cache = [0 => 1, 1 => 1];
if (!isset($cache[$n])) {
$cache[$n] = $n * factorial($n - 1);
}
return $cache[$n];
}
特性:僅在函數區域可見,但生命週期贯穿整個腳本執行期,保持值不丟失。
$globalVar = 'I am global';
function testGlobal() {
// 方法一:global 關鍵字(建立參考)
global $globalVar;
echo $globalVar; // I am global
$globalVar = 'changed';
}
function testGlobalsArray() {
// 方法二:$GLOBALS 超全域陣列
echo $GLOBALS['globalVar']; // changed
$GLOBALS['newVar'] = 'created in function';
}
testGlobal();
testGlobalsArray();
echo $GLOBALS['newVar']; // created in function
差異:global $var 建立到全域變數的參考(別名);$GLOBALS['var'] 直接存取超全域陣列元素。global 在函數內部建立區域別名,$GLOBALS 可在任何作用域直接存取。
$a = 10;
$b = &$a; // $b 是 $a 的參考(別名)
$b = 20;
echo $a; // 20
// 函數參數參考傳遞
function addPrefix(&$str, string $prefix) {
$str = $prefix . $str;
}
$name = 'John';
addPrefix($name, 'Mr. ');
echo $name; // Mr. John
// 參考回傳(PHP 7.0+)
class Container {
private $data = [];
public function &getRef(string $key) {
return $this->data[$key];
}
}
$c = new Container();
$c->getRef('key') = 'value'; // 修改內部資料
規則:只有具名變數可被參考($a = &$b),運算式/常數/函數回傳值不可($a = &(1+2) 錯誤)。unset($b) 僅斷開參考關聯,不銷毀資料。
| 變數 | 用途 | 範例 | 安全性注意 |
|---|---|---|---|
$GLOBALS | 所有全域變數參考 | $GLOBALS['var'] | 謹慎使用,增加耦合 |
$_SERVER | 伺服器/執行環境資訊 | $_SERVER['REQUEST_URI'] | 含用戶可控標頭(HTTP_*),需驗證 |
$_GET | URL 查詢字串參數 | $_GET['id'] | 輸入驗證、防 XSS/SQLi |
$_POST | POST 請求主體參數 | $_POST['username'] | 同上,需 CSRF 保護 |
$_COOKIE | Cookie 值 | $_COOKIE['session_id'] | 不可信,勿直接用於 SQL |
$_FILES | 上傳檔案資訊 | $_FILES['avatar']['tmp_name'] | 嚴格驗證類型、大小、副檔名 |
$_ENV | 環境變數 | $_ENV['APP_ENV'] | 生產環境敏感資訊勿硬編碼 |
$_REQUEST | $_GET+$_POST+$_COOKIE 合併 | $_REQUEST['id'] | 不推薦使用,來源不明、順序依 variables_order 設定 |
$_SESSION | Session 變數 | $_SESSION['user_id'] | 需 session_start(),注意鎖機制 |
$x = 1; // 全域
function foo() {
$y = 2; // 區域
echo $x; // Notice: Undefined variable $x(PHP 不自動引入全域)
}
foo();
// 正確做法
function foo() {
global $x;
echo $x; // 1
}
// 或
function foo() {
echo $GLOBALS['x'];
}
// vars.php
$includedVar = 'from include';
// main.php
function test() {
include 'vars.php';
echo $includedVar; // 可見!include 在函數內執行,變數屬於函數區域作用域
}
test();
class A {
public $pub = 1;
protected $pro = 2;
private $pri = 3;
}
$a = new A();
echo $a->pub; // 1
// echo $a->pro; // Fatal: Cannot access protected property
// echo $a->pri; // Fatal: Cannot access private property
declare(strict_types=1); // 必須為檔案第一行
function add(int $a, int $b): int {
return $a + $b;
}
add(1, 2); // 3
add(1.5, 2.5); // TypeError: Argument must be int, float given
add('1', '2'); // TypeError(嚴格模式不自動轉型)
嚴格模式僅影響標量型別宣告的函數呼叫與回傳,不影響內部運算、陣列/物件型別。
| 錯誤模式 | 問題 | 正確做法 |
|---|---|---|
漏寫 $ | 語法錯誤/常數視為字串 | IDE 自動補全、靜態分析 |
| 未定義變數直接使用 | Warning/Notice,行為不可預期 | 先初始化,或用 ?? 提供預設值 |
| foreach 參考未 unset | 後續迴圈汙染資料 | 迴圈結束 unset($ref) |
| 濫用 global/$GLOBALS | 高耦合、難測試、難維護 | 依賴注入、服務容器、參數傳遞 |
| 可變變數動態存取 | 不可讀、靜態分析失效、安全風險 | 改用陣列/物件/集合 |
| $_REQUEST 混用來源 | 參數汙染、CSRF 風險 | 明確使用 $_GET/$_POST/$_COOKIE |
| 直接信任超全域輸入 | XSS、SQLi、路徑遍歷、命令注入 | 輸入驗證、輸出編碼、參數化查詢 |
declare(strict_types=1) 放在每個檔案頂部const、readonly (PHP 8.1+)、final 類別,減少可變狀態global/$GLOBALS/$_SERVER 直接在業務邏輯中使用,透過建構子注入$_GET/$_POST,核心邏輯只處理純資料物件(DTO)PHP 變數機制包含命名、定義、作用域、參考、超全域等多層面。核心原則:最小作用域、明確型別、不可變優先、依賴注入、邊界驗證。掌握 static、&、global/$GLOBALS、$_SERVER/$_GET/$_POST 等機制的具體行為與陷阱,能避開 90% 的變數相關 Bug,寫出可維護、可測試、安全的現代 PHP 程式碼。