PHP 命名空間（Namespace）基礎教學與實戰範例

什麼是 PHP 命名空間？

PHP 命名空間是 PHP 5.3 版本引入的重要特性，其概念類似於 C# 的命名空間。簡單來說，命名空間就像是一個虛擬目錄，將程式碼封裝在特定的空間內，避免類別、函數、常數命名衝突。

命名空間解決的三大衝突問題

• 常數命名衝突
• 函數命名衝突
• 類別命名衝突

基本語法與使用範例

/* 
|--------------------------------- 
| 命名空間示例 
| @作者 
|--------------------------------- 
*/
namespace myself;

function var_dump() {
    echo 100;
}

var_dump();              // 呼叫自訂函數（相對路徑）
\myself\var_dump();      // 呼叫自訂函數（絕對路徑）
\var_dump(100);          // 呼叫全域（系統內建）函數

注意事項：

• namespace 宣告必須是檔案中的第一行程式碼（除 declare() 外）。
• 多個檔案可使用相同命名空間，但同一命名空間內定義的內容不得衝突。
• 支援子命名空間，如 namespace \myself\good，對應多層目錄結構。

單一檔案定義多個命名空間

雖然語法允許，但實務上不建議在同一檔案定義多個命名空間，主要用於合併多個腳本的特殊場景。

寫法一：連續宣告

namespace nihao\shijie;
function demo() { /* ... */ }

namespace hello\world;
function test() { /* ... */ }

\nihao\shijie\demo();
\hello\world\test();

寫法二：大括號包裹（推薦）

namespace nihao\shijie {
    function test_one() { /* ... */ }
}

namespace hello\world {
    function test_two() { /* ... */ }
}

\nihao\shijie\test_one();
\hello\world\test_two();

名稱解析規則

善用命名空間能有效組織大型專案代碼，避免命名污染，是現代 PHP 開發的基礎技能。