Laravel 5 正式釋出,帶來了翻天覆地的架構重設計。由於國內資料尚少,筆者翻閱官方文檔與原始碼,整理出以下核心變更,助您快速遷移與上手。
Laravel 5 的目錄結構與 4.2 版差異極大,核心理念是「按功能領域組織」而非「按技術類型分層」。新結構概覽:
app/
Commands/
Console/
Events/
Handlers/
Commands/
Events/
Http/
Controllers/
Middleware/
Requests/
Kernel.php
routes.php
Providers/
Services/
bootstrap/
config/
database/
migrations/
seeds/
public/
resources/
lang/
views/
storage/
cache/
logs/
meta/
sessions/
views/
work/
tests/
對比 4.2 版:
config/、database/ 升至根目錄,配置更直觀。lang/、views/ 歸入 resources/,符合資源統一管理原則。controllers/ 併入 Http/Controllers/,強調 HTTP 層職責。models/ 目錄移除,模型類現在可自由置於 app/ 下任意位置(建議自建 app/Models/)。Middleware/、Requests/、Services/ 等目錄,支援中介軟體、表單請求、服務層等現代模式。app/ 目錄現在預設綁定 App 根命名空間,所有子目錄類別均須遵循 PSR-4 自動載入標準。例如 app/Http/Controllers/Auth/AuthController.php 的命名空間為 App\Http\Controllers\Auth。這讓專案結構更清晰,也與 Composer 生態無縫銜接。
Http/ 目錄現在集中處理所有 HTTP 請求相關邏輯:
filters.php,以類別形式定義,於 Kernel.php 註冊為全域或路由級中介軟體,功能更強、可測試性更高。App\Http\Controllers,例如 'auth' => 'Auth\AuthController' 會自動解析至 App\Http\Controllers\Auth\AuthController。php artisan route:cache 大幅提升路由解析效能;php artisan route:clear 清除快取。app/Services/ 目錄鼓勵將業務邏輯從控制器剝離。以內建認證為例:AuthController 構造函數透過依賴注入取得 Registrar 服務,驗證與建立用戶邏輯完全封裝於 App\Services\Registrar,控制器代碼極其精簡:
public function postRegister(Request $request) {
$validator = $this->registrar->validator($request->all());
if ($validator->fails()) { $this->throwValidationException($request, $validator); }
$this->auth->login($this->registrar->create($request->all()));
return redirect($this->redirectPath());
}
這樣的分層讓業務邏輯可複用、可測試、易維護,強烈建議在專案中廣泛採用。
移除預設 models/ 目錄,是因為並非所有專案都需資料庫。開發者可自行在 app/ 下建立 Models/ 目錄,類別命名空間為 App\Models。雖需額外 use 引入,但換來結構清晰、命名空間統一管理的長遠收益。
Laravel 5 的這些變更體現了現代 PHP 框架的演進方向:更嚴謹的分層、更標準的自動載入、更強大的依賴注入與中介軟體機制。建議開發者投入時間重構既有專案,或以新架構啟動新專案,將長期受益於可維護性與擴展性的提升。