命名空間解決類別/函數/常量命名衝突,並提供別名機制縮短代碼。PHP 5.3+ 正式支援,現代框架(Laravel、Symfony)皆大量使用。
<?php
// 必須是檔案第一個非 declare 語句,前面不能有任何輸出(含空白)
namespace MyProject;
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
namespace MyProject; 開頭)namespace { ... }| 方式 | 語法 | 解析規則 | 例子 |
|---|---|---|---|
| 非限定名稱 | Foo::bar() | 當前命名空間下 | namespace A; Foo::bar() → A\Foo::bar() |
| 限定名稱 | Sub\Foo::bar() | 相對於當前命名空間 | namespace A; Sub\Foo → A\Sub\Foo |
| 完全限定名稱 | \Foo::bar() | 絕對路徑(全域空間) | namespace A; \Foo → Foo |
namespace MyApp;
strlen('abc'); // 1. 找 MyApp\strlen → 2. 找全域 \strlen
echo FOO; // 1. 找 MyApp\FOO → 2. 找全域 FOO
類別**無後備機制**:new Foo() 只找 MyApp\Foo,找不到觸發 __autoload。
namespace MyApp;
use Other\Long\Namespace\ClassName as ShortName;
use Other\Ns2; // 等同 use Other\Ns2 as Ns2;
use function Other\funcName;
use const Other\CONST_NAME;
new ShortName(); // 實際為 Other\Long\Namespace\ClassName
namespace MyApp;
$class = 'Foo';
new $class(); // 解析為 Foo(全域),非 MyApp\Foo
$class = 'MyApp\Foo'; // 或 '\MyApp\Foo'
new $class(); // 正確解析
// 雙引號字串需雙重轉義
$ns = \"MyApp\\Sub\";
new $ns.'Foo'();
src/Controller/UserController.php → namespace App\Controller;