上篇介紹的「路徑前綴 + 回退」方案雖實用,但存在痛點:模板內 @extends('layout.master') 必須寫死完整路徑,主題間無法完全隔離。本文介紹更規範的 View Namespace(視圖命名空間) 機制,實現主題級別的完全隔離與零前綴調用。
Laravel 視圖尋找器支援「命名空間::相對路徑」語法,類似套件視圖載入:
// 註冊命名空間對應的物理路徑
View::addNamespace('default', app_path('views/default'));
View::addNamespace('blue', app_path('views/blue'));
View::addNamespace('red', app_path('views/red'));
View::addNamespace('green', app_path('views/green'));
// 渲染時指定命名空間
return View::make('green::index.index'); // → resources/views/green/index/index.blade.php
期望能設定「預設命名空間」,後續 View::make('index.index') 自動解析為當前主題:
// 願景:一次設定,處處生效
View::setDefaultNamespace('blue', app_path('views/blue'));
// 之後直接
View::make('index.index'); // 實際載入 blue::index.index
但 Laravel 核心並未提供 setDefaultNamespace 方法,需自行擴展或採用替代方案。
利用服務提供者在啟動階段動態註冊 theme 命名空間,並將其設為預設:
// app/Providers/ThemeServiceProvider.php
public function boot() {
$theme = config('app.theme', 'default'); // 或從資料庫讀取
$path = app_path("views/{$theme}");
// 註冊 theme 命名空間指向當前主題目錄
View::addNamespace('theme', $path);
// 可選:同時註冊 default 命名空間作為回退
if ($theme !== 'default') {
View::addNamespace('default', app_path('views/default'));
}
}
模板中統一使用 theme:: 前綴:
{{-- resources/views/blue/index/index.blade.php --}}
@extends('theme::layouts.master') {{-- 解析為 blue/layouts/master --}}
@section('content')
Welcome to Blue Theme
@endsection
// ThemeServiceProvider::boot()
$theme = Option::getByKey('theme'); // 假設 Option 模型讀取設定表
View::addNamespace('theme', app_path("views/{$theme}"));
管理員在後台修改 theme 設定值,下次請求自動生效,無需部署代碼。
| 特性 | 路徑前綴法 | 命名空間法 |
|---|---|---|
| 主題隔離性 | 需回退邏輯 | 天然隔離,不存在即報錯 |
| @extends/ @include | 需寫全路徑 | 統一用 theme:: 相對路徑 |
| 新增主題成本 | 建目錄即可 | 建目錄 + 註冊命名空間 |
| 運行時切換 | 配置修改即時生效 | 同樣支援 |
命名空間方案更符合 Laravel 設計哲學,適合對模板隔離性要求高、主題數量較多的專案。建議結合 View::composer() 向所有主題模板注入共享變數(如當前主題名、配色變數),進一步提升開發體驗。