PHP use 關鍵字完整解析：命名空間別名與導入機制

PHP 5.3 引入命名空間後，use 關鍵字成為管理類別、介面、命名空間別名的核心機制，類似 Unix 系統的符號連結。本文系統解析其三種別名模式、編譯時特性與進階用法。

三種別名模式

基本用法範例

<?php
namespace Foo;

use My\Full\ClassName as Another;
use My\Full\NSName;           // 等同 use My\Full\NSName as NSName
use ArrayObject;              // 導入全域類別

$obj = new Another();         // 實例化 My\Full\ClassName
$obj = new NSName\Sub\Class(); // 存取 My\Full\NSName\Sub\Class
$a = new ArrayObject([1]);    // 實例化全域 ArrayObject
?>

進階特性

單行多重導入

use My\Full\ClassName as Another, My\Full\NSName;

編譯時執行（重要）

use 在編譯階段解析，不影響動態類別名稱：

use My\Full\ClassName as Another;
$name = 'Another';
$obj = new $name(); // 實例化「Another」類別，而非 My\Full\ClassName

全域類別導入

為全域類別建立別名，避免與當前命名空間同名類別衝突：

namespace Foo;
use ArrayObject; // 導入全域 \ArrayObject
// 若無此行，new ArrayObject() 會嘗試實例化 Foo\ArrayObject

命名規範與最佳實踐

• 完整限定名稱：use 後必須跟完整命名空間路徑（含分隔符 \），不可省略前導 \（雖可加但不建議）
• 避免與內建類別同名：若在命名空間中定義 ArrayObject 類別，未 use 導入全域類別會造成衝突
• 群組導入：PHP 7.0+ 支援群組 use 語法：use My\Lib\{ClassA, ClassB, ClassC as C};
• 函數/常數導入：PHP 5.6+ 支援 use function、use const 導入函數與常數

常見錯誤對照

掌握 use