命名空間是標識符的作用域容器,解決:
類比文件系統:命名空間 = 目錄,類/函數/常量 = 文件。同目錄下文件名唯一,不同目錄可同名。
僅三類:類 (含介面、Trait、枚舉)、函數、常量 (僅 `const` 定義,`define()` 不受影響)。
<?php
// 文件開頭第一條語句 (前面只能有 declare)
namespace MyProject;
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
// 子命名空間 (目錄層級感)
namespace MyProject\Database;
class Connection { /* ... */ } // 不衝突
?>
錯誤示範:
<?php
$a = 1;
namespace MyProject; // Fatal Error: Namespace declaration must be the very first statement
?>
兩種語法:
<?php
// 1. 連續聲明 (稀疏)
namespace A { const C = 1; class Foo {} }
namespace B { const C = 2; class Foo {} }
namespace { // 全局空間
const C = 3; class Foo {}
}
// 2. 大括號語法 (推薦若必須用)
namespace MyProject {
const CONNECT_OK = 1;
class Connection {}
}
namespace AnotherProject {
const CONNECT_OK = 1;
class Connection {}
}
?>
| 方式 | 語法 | 解析規則 (當前命名空間 Current\NS) |
|---|---|---|
| 非限定名稱 | Foo::method()func()CONST | 解析為 Current\NS\Foo、Current\NS\func、Current\NS\CONST。函數/常量回退:若當前 NS 無定義,嘗試全局空間。 |
| 限定名稱 | Sub\Foo::method() | 解析為 Current\NS\Sub\Foo (相對路徑)。 |
| 完全限定名稱 | \Other\Foo::method()\func()\CONST | 以 `\` 開頭,解析為 Other\Foo、全局 `func`、全局 `CONST`。相當於絕對路徑,不受當前命名空間影響。 |
use 操作符<?php
namespace App\Controller;
use App\Model\User; // 導入類,別名 User
use App\Model\Order as OrderModel; // 導入並別名
use function App\Helper\formatDate; // 導入函數 (PHP 5.6+)
use const App\Config\MAX_SIZE; // 導入常量 (PHP 5.6+)
// 使用
$user = new User(); // 實際 new App\Model\User()
$order = new OrderModel(); // 實際 new App\Model\Order()
echo formatDate(time()); // 調用 App\Helper\formatDate()
echo MAX_SIZE; // 使用 App\Config\MAX_SIZE
?>
注意: `use` 必須在命名空間聲明後、其他代碼前。不支持動態別名 (如 `use $var as Alias`)。
PHP 編譯時解析靜態引用,動態調用 (變量類名/函數名) 發生在運行時,**不自動加上當前命名空間前綴**!
<?php
namespace My\Space;
class Foo { public function say() { echo "My\Space\Foo\n"; } }
$class = 'Foo';
new $class(); // 實例化全局 \Foo (若存在),而非 My\Space\Foo!
// 正確動態調用:手動拼接完全限定名
$class = 'My\Space\Foo'; // 或 __NAMESPACE__ . '\Foo'
new $class(); // 正確
// 雙引號字串中反斜杠需轉義
$class = "My\\Space\\Foo";
?>
現代 PHP 專案遵循 PSR-4:命名空間前綴映射到目錄路徑。
// composer.json 自動加載配置
{
"autoload": {
"psr-4": {
"App\\": "src/",
"Vendor\\Package\\": "packages/vendor/package/src/"
}
}
}
// 類 App\Controller\User → src/Controller/User.php
// 類 Vendor\Package\Service → packages/vendor/package/src/Service.php
運行 `composer dump-autoload` 生成映射表,`require 'vendor/autoload.php'` 即可自動加載。