萬盛學電腦網

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

PHP 變數完整指南:定義規則、作用域、靜態變數、參考賦值與超全域變數

變數是 PHP 程式的基本構建塊。本文系統整理變數命名規則、定義方式、作用域規則、靜態變數、參考賦值機制、超全域變數與常見最佳實踐。

變數命名規則

  • 以 $ 開頭,後接字母或底線:$var, _var
  • 後續可包含字母、數字、底線:$var_name_123
  • 區分大小寫:$var ≠ $Var ≠ $VAR
  • 不可包含空格,多單詞慣用 snake_case($user_name)或 camelCase($userName)
  • 避免使用 PHP 保留字(如 $this, $GLOBALS 等)

變數定義的七種形式

1. 一般變數

$name = '張三';
$age = 25;
$price = 19.99;
$active = true;

2. 常數(define / const)

// 全域常數(執行期定義)
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 編譯期定義、必須在最上層、區分大小寫、可用於類別。

3. 可變變數(Variable Variables)

$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]

⚠️ 實務極少使用,降低可讀性,僅用於極特殊動態情境。

4. 靜態變數

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];
}

特性:僅在函數區域可見,但生命週期贯穿整個腳本執行期,保持值不丟失。

5. 全域變數與 $GLOBALS

$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 可在任何作用域直接存取。

6. 參考賦值(Reference Assignment)

$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) 僅斷開參考關聯,不銷毀資料。

7. 超全域變數(Superglobals)

變數用途範例安全性注意
$GLOBALS所有全域變數參考$GLOBALS['var']謹慎使用,增加耦合
$_SERVER伺服器/執行環境資訊$_SERVER['REQUEST_URI']含用戶可控標頭(HTTP_*),需驗證
$_GETURL 查詢字串參數$_GET['id']輸入驗證、防 XSS/SQLi
$_POSTPOST 請求主體參數$_POST['username']同上,需 CSRF 保護
$_COOKIECookie 值$_COOKIE['session_id']不可信,勿直接用於 SQL
$_FILES上傳檔案資訊$_FILES['avatar']['tmp_name']嚴格驗證類型、大小、副檔名
$_ENV環境變數$_ENV['APP_ENV']生產環境敏感資訊勿硬編碼
$_REQUEST$_GET+$_POST+$_COOKIE 合併$_REQUEST['id']不推薦使用,來源不明、順序依 variables_order 設定
$_SESSIONSession 變數$_SESSION['user_id']需 session_start(),注意鎖機制

變數作用域規則

全域 vs 區域

$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'];
}

include/require 不改變作用域


// 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

型別宣告與嚴格模式(PHP 7.0+)

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、路徑遍歷、命令注入輸入驗證、輸出編碼、參數化查詢

現代 PHP 變數管理最佳實踐

  1. 啟用嚴格模式:declare(strict_types=1) 放在每個檔案頂部
  2. 型別宣告:函數參數、回傳值、類別屬性(PHP 7.4+)盡量加上型別
  3. 不可變傾向:預設用 const、readonly (PHP 8.1+)、final 類別,減少可變狀態
  4. 依賴注入:避免 global/$GLOBALS/$_SERVER 直接在業務邏輯中使用,透過建構子注入
  5. 輸入邊界驗證:在 Controller/Command 層統一驗證 $_GET/$_POST,核心邏輯只處理純資料物件(DTO)
  6. 靜態分析:使用 PHPStan/Psalm 等級 5+ 檢查未定義變數、型別不符、死代碼

總結

PHP 變數機制包含命名、定義、作用域、參考、超全域等多層面。核心原則:最小作用域、明確型別、不可變優先、依賴注入、邊界驗證。掌握 static、&、global/$GLOBALS、$_SERVER/$_GET/$_POST 等機制的具體行為與陷阱,能避開 90% 的變數相關 Bug,寫出可維護、可測試、安全的現代 PHP 程式碼。

copyright © 萬盛學電腦網 all rights reserved