Laravel 5.0 重大更新詳解：新架構、核心特性與開發體驗全面升級

Laravel 5.0 為框架發展歷程中的里程碑版本，帶來全新目錄結構、Contracts 介面體系、路由快取、中介層、依賴注入增強、認證腳手架、事件物件、命令總線、排程任務等革命性特性。本文深度解析各項核心更新與遷移指南。

全新目錄結構

核心變更

• 移除 app/models，程式碼直接置於 app/，預設命名空間 App
• 可透過 php artisan app:name NewNamespace 修改命名空間
• HTTP 層元件集中於 app/Http：Controllers、Middleware、Requests
• Middleware 取代舊版 Filters，各自獨立類別檔案
• app/Providers 取代 app/start，服務提供者管理啟動流程
• 語言檔與視圖移至 resources/

PSR-4 自動載入

全面採用 PSR-4 標準，Composer autoload 設定：

"autoload": {
    "classmap": [
        "app/commands",
        "app/controllers",
        "app/models",
        "app/database/migrations",
        "app/database/seeds",
        "app/tests/TestCase.php"
    ],
    "psr-4": {
        "App\\": "app/"
    }
}

Contracts：介面契約體系

所有核心元件實作 illuminate/contracts 定義的介面：

• 零外部依賴，純介面定義
• 解耦 Facades 與具體實作
• 支援依賴注入替換實作
• 便於單元測試與 Mock

實際應用

// 透過 Contract 注入，而非具體類別
use Illuminate\Contracts\Auth\Registrar;

class AuthController {
    public function __construct(Registrar $registrar) {
        $this->registrar = $registrar;
    }
}

路由效能革命：Route Caching

指令

php artisan route:cache  # 建立快取
php artisan route:clear  # 清除快取

適用場景與效能

• 超過 100 條路由的專案效能提升顯著
• 僅支援 Controller 路由，Closure 路由無法快取
• 部署流程必須包含快取建立步驟

HTTP Middleware（中介層）

從 Filters 到 Middleware

• 單一介面處理所有請求過濾邏輯
• auth、csrf 等內建功能皆轉為 Middleware
• 支援前置/後置處理（$next($request) 前後）
• 可指派給路由群組或單一路由

建立自訂 Middleware

php artisan make:middleware CheckAge

// app/Http/Middleware/CheckAge.php
public function handle($request, Closure $next) {
    if ($request->age < 18) {
        return redirect('home');
    }
    return $next($request);
}

// 路由註冊
Route::get('profile', ['middleware' => 'age', function () {
    // 只有通過檢查才能到達
}]);

控制器方法注入

除了建構子注入，現在可直接在方法簽名型別提示依賴：

public function createPost(Request $request, PostRepository $posts) {
    // IoC 容器自動解析注入
    // 即使路由包含其他參數也能正常運作
}

認證腳手架

內建完整認證系統

• 註冊、登入、密碼重設控制器
• 視圖檔案：resources/views/auth/
• 用戶遷移檔：database/migrations/xxxx_create_users_table.php
• 路由：auth/login、auth/register
• App\Services\Auth\Registrar 處理建立/驗證邏輯

一鍵生成

php artisan make:auth  # 5.2+ 版本指令

事件物件化

從字串到物件

// 定義事件物件
class PodcastWasPurchased {
    public $podcast;
    public function __construct(Podcast $podcast) {
        $this->podcast = $podcast;
    }
}

// 觸發事件
Event::fire(new PodcastWasPurchased($podcast));

// 監聽器接收物件
class ReportPodcastPurchase {
    public function handle(PodcastWasPurchased $event) {
        // $event->podcast 直接存取
    }
}

優勢

• 型別安全與 IDE 支援
• 封裝事件相關資料
• 易於序列化與佇列傳遞

命令總線與佇列

命令物件

class PurchasePodcast extends Command implements SelfHandling, ShouldBeQueued {
    use SerializesModels;
    
    protected $user, $podcast;
    
    public function __construct(User $user, Podcast $podcast) {
        $this->user = $user;
        $this->podcast = $podcast;
    }
    
    public function handle() {
        // 業務邏輯
        event(new PodcastWasPurchased($this->user, $this->podcast));
    }
}

派發命令

// 同步執行
$this->dispatch(new PurchasePodcast($user, $podcast));

// 非同步佇列（需配置 queue worker）
// 相同程式碼，自動進入佇列

資料庫佇列驅動

內建 database 佇列驅動，無需安裝 Redis/Beanstalkd 即可使用佇列功能。

排程任務

告別 Crontab 分散管理

// app/Console/Kernel.php
protected function schedule(Schedule $schedule) {
    $schedule->command('artisan:command')->dailyAt('15:00');
    $schedule->call(function () { /* ... */ })->hourly();
    $schedule->exec('script.sh')->weekly();
}

伺服器僅需單一 Crontab

* * * * * php /path/to/artisan schedule:run >> /dev/null 2>&1

其他重要特性

升級遷移指南

1. 目錄結構重組：移動檔案至新位置，更新命名空間
2. Middleware 遷移：將 filters 轉為 Middleware 類別
3. 服務提供者：將 start 檔案邏輯移至 Providers
4. 路由檢查：Closure 路由改為 Controller 以支援快取
5. Composer 更新：調整 autoload 為 PSR-4
6. 測試驗證：完整跑測試套件確保功能正常

總結

Laravel 5.0 不僅是版本號躍升，更是架構層面的重大重構。新目錄結構符合現代 PHP 標準，Contracts 體系奠定可擴展基礎，Middleware 統一請求處理，命令總線與排程任務解決長期痛點。對於新專案，建議直接採用 5.0+ 架構；現有 4.2 專案評估遷移成本後，可分階段升級。掌握這些核心特性，能充分發揮 Laravel 開發效能與維護性優勢。