PHP 命名空間完整指南：從基礎語法到進階應用

為什麼需要命名空間？

解決類別/函式/常數命名衝突。傳統做法加前綴（如 Article_Comment）導致名稱冗長、維護困難。命名空間提供隔離機制，類似檔案系統目錄結構。

基本語法

<?php
// 必須是檔案第一行（前面不能有任何輸出或程式碼）
namespace MyProject\Blog;

class Comment { }
function getTotal() { return 100; }
const VERSION = '1.0';

錯誤示範：namespace 前有 HTML 輸出、變數宣告、甚至空白行都會導致致命錯誤。

多命名空間與子空間

<?php
namespace Blog\Article;
class Comment { }

namespace Blog\MessageBoard;
class Comment { }

// 當前空間直接使用
$c1 = new Comment();                    // Blog\MessageBoard\Comment
// 跨空間使用完全限定名稱
$c2 = new \Blog\Article\Comment();      // Blog\Article\Comment

三種名稱解析規則

use 導入與別名

<?php
namespace BBS;

use Blog\Article;           // 導入空間
use Blog\Article as Art;    // 空間別名
use Blog\Article\Comment;   // 導入類別
use Blog\Article\Comment as Cmt; // 類別別名

$c1 = new Article\Comment(); // 限定名稱
$c2 = new Art\Comment();     // 別名
$c3 = new Comment();         // 非限定名稱（導入類別後）
$c4 = new Cmt();             // 類別別名

導入衝突：若當前空間已有同名元素，use 會導致致命錯誤，需用別名避開。

動態存取與字串陷阱

<?php
namespace Blog\Article;
class Comment { }

// 1. namespace 關鍵字
$c = new namespace\Comment();

// 2. __NAMESPACE__ 魔術常數
$class = __NAMESPACE__ . '\Comment';
$c = new $class();

// ⚠️ 雙引號轉義陷阱
$bad = __NAMESPACE__ . "\Comment"; // \C 被轉義！
$good = __NAMESPACE__ . '\\Comment'; // 單引號或雙重轉義

// ⚠️ 字串調用永遠視為非限定或完全限定，不支援限定名稱
use Blog\Article\Common;
$obj = new 'Common';          // 錯誤：視為當前空間 Common
$obj = new 'Article\Common';  // 錯誤：視為全域 Article\Common

公共空間

未宣告 namespace 的程式碼屬於公共空間。呼叫公共空間元素需加前導 \：new \FilterXSS()。PHP 內建類別/函式/常數皆屬公共空間。

最佳實踐建議

• 專案初期規劃命名空間結構（如 Vendor\Package\Component）。
• 遵循 PSR-4 自動載入標準，目錄結構對應命名空間。
• 編寫通用庫/套件時務必使用命名空間，避免全域污染。
• 避免過深巢狀（建議 ≤ 3 層），平衡清晰度與輸入便利性。