萬盛學電腦網

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

PHP global 關鍵字詳解:全局變量的正確使用與替代方案

global 關鍵字基本用法

<?php
$myVar = 'Hello World';

function testGlobal() {
    // 函數作用域內無法直接訪問 $myVar
    // echo $myVar; // Notice: Undefined variable
    
    // 引入全局變量
    global $myVar;
    echo $myVar; // Hello World
    
    // 修改全局變量
    $myVar = 'Modified';
}

testGlobal();
echo $myVar; // Modified
?>

為什麼要避免過度使用 global

三大弊端

  1. 代碼復用極難:函數強依賴特定全局變量名,移植到其他項目/上下文需大幅修改。
  2. 調試極其困難:全局變量可在任意處被修改 (include 文件、其他函數、異步回調),Bug 定位如大海撈針。
  3. 認知負擔重:變量定義、修改、使用分散各處,新成員/長期維護者極難理清數據流向。

替代方案:依賴注入與現代模式

1. 函數參數傳遞 (最簡單、最推薦)

<?php
// ❌ 依賴全局
function saveUser() {
    global $db;
    $db->insert('users', $_POST);
}

// ✅ 顯式依賴
function saveUser(PDO $db, array $data): bool {
    return $db->insert('users', $data);
}

// 調用
saveUser($pdo, $_POST); // 清晰、可測試、可復用
?>

2. 服務容器 / 依賴注入容器 (大型項目)

<?php
// 簡易容器示例
class Container {
    private $services = [];
    private $factories = [];
    
    public function bind(string $id, callable $factory) {
        $this->factories[$id] = $factory;
    }
    
    public function get(string $id) {
        if (isset($this->services[$id])) return $this->services[$id];
        if (!isset($this->factories[$id])) throw new Exception("Service $id not found");
        return $this->services[$id] = $this->factories[$id]($this);
    }
}

$container = new Container();
$container->bind('db', fn($c) => new PDO('mysql:host=localhost;dbname=test', 'user', 'pass'));
$container->bind('user_repo', fn($c) => new UserRepository($c->get('db')));

// 使用
$userRepo = $container->get('user_repo');
$userRepo->save(['name' => 'John']);
?>

3. 單例模式 / 靜態門面 (謹慎使用)

<?php
class Database {
    private static ?PDO $instance = null;
    
    public static function getInstance(): PDO {
        if (!self::$instance) {
            self::$instance = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
            self::$instance->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        }
        return self::$instance;
    }
    
    // 禁止克隆/序列化
    private function __clone() {}
    public function __wakeup() { throw new Exception('不可序列化'); }
}

// 使用
$db = Database::getInstance();
$stmt = $db->query('SELECT 1');
?>

4. 配置對象 / 值對象

<?php
// 替代全局配置數組
class AppConfig {
    public function __construct(
        public readonly string $dbHost,
        public readonly string $dbName,
        public readonly string $appEnv,
        public readonly int $cacheTtl
    ) {}
}

// 構建一次,到處傳遞
$config = new AppConfig('localhost', 'myapp', 'prod', 3600);
function connect(AppConfig $config): PDO { /* ... */ }
?>

5. 請求上下文對象 (Web 框架模式)

<?php
class RequestContext {
    public function __construct(
        public array $get,
        public array $post,
        public array $server,
        public array $cookies,
        public ?User $user = null
    ) {}
}

// 中間件創建上下文,控制器接收
function handleRequest(RequestContext $ctx) {
    // 完全可測試,無全局依賴
}
?>

不得不使用 global 的極少數場景

  • 維護無法重構的古老代碼庫。
  • PHP 內置超全局數組 ($GLOBALS, $_GET, $_POST, $_SESSION) 本質即全局,框架通常封裝為 Request 對象。
  • 極簡腳本/一次性腳本,架構成本過高。

global vs $GLOBALS 對比

<?php
$x = 1;

function testGlobal() {
    global $x;
    $x = 2; // 修改全局 $x
}

function testGlobals() {
    $GLOBALS['x'] = 3; // 修改全局 $x
    // 區別:$GLOBALS 可用動態變量名
    $varName = 'x';
    $GLOBALS[$varName] = 4;
}

testGlobal();  // $x = 2
testGlobals(); // $x = 4
?>

總結

global 是 PHP 早期為過程式代碼設計的妥協產物。現代 PHP (5.3+) 應採用依賴注入、服務容器、請求上下文對象等模式,實現顯式依賴、易測試、高復用、低耦合的代碼架構。將全局狀態最小化、局部化、封裝化,是專業 PHP 開發者的核心素養。

copyright © 萬盛學電腦網 all rights reserved