PHP 5.3 引入命名空間,解決類/函數/常量命名衝突,支持代碼模組化、框架互操作 (PSR-0/PSR-4)。雖在 PHP 5.0 曾計劃後推至 6.0,最終在 5.3 落地,標誌著 PHP 進入現代化發展階段。
<?php
// 必須是文件第一條非註釋代碼 (declare 除外)
namespace MyProject\Blog;
class Post {
const STATUS_PUBLISHED = 1;
public function publish() { /* ... */ }
}
function formatDate($timestamp) { /* ... */ }
const DEFAULT_LIMIT = 10;
Vendor\Package\SubNamespace (StudlyCaps)。namespace A { ... } namespace B { ... }。<?php
namespace MyProject\Blog;
$post = new Post(); // 解析為 MyProject\Blog\Post
formatDate(time()); // 解析為 MyProject\Blog\formatDate
<?php
namespace MyProject;
$post = new Blog\Post(); // 解析為 MyProject\Blog\Post
<?php
namespace OtherProject;
$post = new \MyProject\Blog\Post(); // 絕對路徑
echo \MyProject\Blog\DEFAULT_LIMIT;
<?php
namespace App\Controller;
use MyProject\Blog\Post; // 導入類
use MyProject\Blog\Post as BlogPost; // 別名
use MyProject\Blog\{Post, Comment, User}; // 批量導入 (PHP 7+)
use function MyProject\Blog\formatDate; // 導入函數
use function MyProject\Blog\formatDate as fmtDate;
use const MyProject\Blog\DEFAULT_LIMIT; // 導入常量
use const MyProject\Blog\DEFAULT_LIMIT as LMT;
// 使用
$post = new Post(); // MyProject\Blog\Post
$post = new BlogPost(); // 別名
$date = fmtDate(time()); // 函數別名
echo LMT; // 常量別名
<?php
namespace MyProject\Blog;
$className = 'Post';
$obj = new $className(); // 解析為 MyProject\Blog\Post
$className = '\Other\Post';
$obj = new $className(); // 解析為 Other\Post (帶前導 \)
echo __NAMESPACE__; // 輸出 "MyProject\Blog"
// 完全限定名動態調用
$fqcn = __NAMESPACE__ . '\Post';
$obj = new $fqcn();
<?php
// 簡易 PSR-4 自動加載器
spl_autoload_register(function ($class) {
$prefix = 'MyProject\\';
$baseDir = __DIR__ . '/src/';
$len = strlen($prefix);
if (strncmp($prefix, $class, $len) !== 0) return;
$relativeClass = substr($class, $len);
$file = $baseDir . str_replace('\\', DIRECTORY_SEPARATOR, $relativeClass) . '.php';
if (file_exists($file)) {
require $file;
}
});
// Composer 生成的自動加載器 (vendor/autoload.php) 完美支持 PSR-4
require __DIR__ . '/vendor/autoload.php';
未聲明命名空間的代碼屬於全局空間。在命名空間內訪問全局類/函數/常量,需加前導 \:
<?php
namespace MyProject;
$time = \time(); // 全局函數
$exception = new \Exception(); // 全局類
$eol = \PHP_EOL; // 全局常量
src/MyProject/Blog/Post.php 對應 MyProject\Blog\Post。namespace 必須在文件開頭 (除 declare 外),前面不能有任何輸出 (包括空白)。use DateTime as DateTimeImmutable 類型暗示)。use 導入,代碼中使用短名,可讀性高、重構易 (IDE 支持重命名)。App\Controller, App\Model, App\Service。\:new Exception() 會嘗試找 Current\Namespace\Exception,應寫 new \Exception()。use 導入函數/常量忘記 use function/use const (PHP 5.6+ 支持)。\ 導致解析為相對命名空間。命名空間是 PHP 現代化基石,配合 Composer、PSR-4、框架路由、依賴注入容器,構建了清晰、可擴展、可維護的應用架構。深入理解其解析規則、導入機制、動態特性,是高級 PHP 開發者的必修課。