在 PHP 開發中,隨著專案規模增長,引入多個第三方庫或自建模組時,類別、函數、常數命名衝突的風險隨之增加。早期 PHP 所有類別定義皆為全域,開發者只能透過冗長的前綴(如 My_Library_DB)來區分,導致程式碼難以維護。PHP 5.3 引入命名空間機制,從根本上解決此問題,讓開發者能夠清晰劃分程式碼的作用域,避免命名衝突,提升程式碼的可讀性與可維護性。
命名空間必須宣告在 PHP 檔案的最頂端,使用 namespace 關鍵字:
<?php
namespace MyProject\Database;
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
?>
同一個命名空間可跨多個檔案使用,但僅能包含類別、介面、函數、常數與 const 定義,不可包含自由程式碼(如直接輸出的 echo)。
:: 前綴):直接對應該命名空間下的元素,如 MyProject\Database\Connection。use 匯入與別名透過 use 操作符可將外部命名空間引入當前作用域,簡化呼叫:
<?php
require 'MyProject/Database/Connection.php';
// 基本匯入
use MyProject\Database;
use MyProject\Database\Connection as DbConnection;
// 使用方式
$x = new MyProject\Database\Connection();
$y = new Database\Connection();
$z = new DbConnection();
Database\connect();
?>
注意事項:use 僅能用於全域範圍,不能置於函數或類別內部;建議放在檔案開頭以避免衝突。
:: 前綴未宣告命名空間的程式碼屬於全域空間。在命名空間內部,若需呼叫全域函數或類別,可加上 :: 前綴:
<?php
namespace A\B\C;
function fopen() {
// 呼叫全域 fopen
$f = \fopen(...);
return $f;
}
?>
__NAMESPACE__此常數在編譯時期被定義為當前命名空間名稱(字串),若在全域空間則為空字串。常用於動態回呼:
<?php
namespace A\B\C;
function foo() { /* ... */ }
set_error_handler(__NAMESPACE__ . '\foo');
?>
| 規則 | 說明 |
|---|---|
| 1. 完整限定名稱 | 依當前匯入規則轉換,如已匯入 A\B\C,則 C\D\E() 轉為 A\B\C\D\E() |
| 2. 非限定類別名 | 依匯入規則轉換,如已匯入 A\B\C,new C() 轉為 A\B\C() |
| 3. 當前命名空間函數 | 編譯期直接解析為當前命名空間函數 |
| 4. 未定義函數回退 | 依序:當前命名空間 → 內建函數 → 全域函數(加 \ 前綴) |
| 5. 未定義類別回退 | 依序:當前命名空間 → 內建類別 → 自動載入 → 全域類別(new \C()) |
| 6. 完整限定函數呼叫 | 執行期解析:當前命名空間 → 全域函數 |
| 7. 完整限定類別實例化 | 執行期依對應命名空間載入,如 new A\B\C() 參照 A\B 下的 C 類別 |
<?php
namespace A;
foo(); // 1. A\foo 2. 內建 foo 3. \foo
\foo(); // 全域 foo
new B(); // 1. A\B 2. 內建 B 3. \B
new \B(); // 全域 B
B\foo(); // 1. A\B\foo 2. 內建 B::foo
\B\foo(); // 1. B\foo 2. \B::foo
A\foo(); // 1. A\A\foo 2. A\A::foo 3. A\foo 4. 內建 A::foo
\A\foo(); // 1. A\foo 2. \A::foo
?>
use 別名簡化長名稱,但避免過度別名導致語義不清。Vendor\Package)。掌握命名空間是邁向現代化 PHP 開發的關鍵一步,它不僅解決命名衝突,更為大型專案的模組化、團隊協作奠定堅實基礎。