PHP 5.3 前,開發者用「前綴底線」避免類別/函數/常數衝突(如 MyProject_Database_Connection),極度冗長。命名空間提供分層級標記,解決命名衝突,提升程式碼組織結構。
<?php
// 必須是檔案第一行(前面只能有 declare)
namespace MyProject;
class Connection { }
// 同一檔案定義多個(不推薦)
namespace MyProject { }
namespace AnotherProject { }
namespace { } // 全域空間
?>
大括號可省略(單一命名空間/檔案時),建議「一檔一空間」。
namespace MyProject\Database;
class Connection { }
namespace MyProject\Blog\Auth\Handler\Social;
class Twitter { }
\ 分隔(曾考慮用 :) 表情符號)namespace A { namespace B { } } 會報錯| 方式 | 語法 | 解析基準 | 範例 |
|---|---|---|---|
| 非限定名稱 | ClassName | 當前命名空間 | MyClass::method() → Current\MyClass |
| 限定名稱 | Sub\ClassName | 當前命名空間的子空間 | new Database\Connection() → Current\Database\Connection |
| 完全限定名稱 | \Top\Sub\ClassName | 全域空間(絕對路徑) | new \MyProject\FileAccess\Input() |
當前空間找不到同名類別/函數時,自動回退到全域空間。故 strlen()、Exception 可直接使用。
<?php
namespace MyProject;
function var_dump($v) { echo "Overloaded!"; }
var_dump($x); // 呼叫覆寫版
\var_dump($x); // 呼叫內建版(前綴 \)
throw new \Exception('fail'); // 必須用完全限定名稱
?>
<?php
namespace OtherProject;
$ns = 'MyProject';
$cls = 'Database\Connection';
$fqn = $ns . '\\' . $cls; // 注意雙反斜線轉義
require strtolower($fqn) . '.php';
$obj = new $fqn();
?>
namespace\ClassName:當前空間的類別(編譯期解析)__NAMESPACE__:當前命名空間字串Vendor\Package\SubNamespace\ClassNameuse 導入常用類別:use MyProject\Database\Connection as DB;