App\Controller, App\Model, Vendor\Package)。use 語句清晰表達依賴。
use App\Service\Order\OrderService; // 導入類
use App\Service\Order\OrderService as OS; // 別名
use function App\Helper\formatPrice; // 導入函數 (PHP 5.6+)
use const App\Config\MAX_ITEMS; // 導入常量 (PHP 5.6+)
use App\Service\{OrderService, Payment\Gateway}; // 群組導入 (PHP 7+)
| 代碼 | 解析為 | 說明 |
|---|---|---|
new OrderService() | App\Service\Order\OrderService | 當前命名空間下的相對類 |
new \App\Service\Order\OrderService() | App\Service\Order\OrderService | 全限定名 (前導 \ 表示全局) |
use App\Service\Order\OrderService; new OrderService() | App\Service\Order\OrderService | 導入後使用短名 |
strlen() | \strlen() | 函數/常量優先查找當前命名空間,再回退全局 |
// composer.json
{
"autoload": {
"psr-4": {
"App\\": "src/",
"Vendor\\Package\\": "packages/vendor-package/src/"
}
}
}
對應目錄結構:
src/
├── Service/
│ └── Order/
│ └── OrderService.php // namespace App\Service\Order; class OrderService {}
packages/
└── vendor-package/
└── src/
└── Gateway.php // namespace Vendor\Package; class Gateway {}
執行 composer dump-autoload 後,new App\Service\Order\OrderService() 即可自動載入。
$class = 'App\\Service\\Order\\' . $serviceName;
$instance = new $class(); // 需確保類已載入
$config = [
'App\\Controller\\' => ['middleware' => ['auth', 'log']],
'App\\Api\\' => ['middleware' => ['rate_limit']],
];
生產環境執行 composer dump-autoload -o 生成 classmap,避免運行時文件系統查找。
"App\\Service" (雙引號需雙重轉義) vs 'App\\Service' (單引號字面量) vs App\Service (代碼中無引號)。命名空間是現代 PHP 專案結構化的基石。**遵循 PSR-4、善用 use/as、配合 Composer 自動加載**,即可實現清晰的模塊邊界、零衝突的第三方集成、高效的自動載入。新專案請從第一行代碼開始規範使用。