Laravel Trait 實戰應用：代碼復用與橫向擴展最佳實踐

Trait 基礎概念

PHP 5.4 引入 Trait，解決單繼承限制，實現「橫向代碼復用」。Trait 類似類但不可實例化，提供方法集合讓類組合使用。

優先順序規則

當前類方法 > Trait 方法 > 父類方法

Laravel 實戰範例

Repository 基礎架構

// GrahamCampbell\Credentials\Repositories\AbstractRepository
abstract class AbstractRepository { /* 共用基礎方法 */ }

功能性 Trait 定義

// 分頁功能 Trait
trait PaginateRepositoryTrait {
    public function paginate($perPage = 15) { /* ... */ }
}

// Slug 查詢功能 Trait
trait SlugRepositoryTrait {
    public function find($slug, array $columns = ['*']) {
        $model = $this->model;
        return $model::where('slug', '=', $slug)->first($columns);
    }
}

具體 Repository 組合使用

namespace GrahamCampbell\BootstrapCMS\Repositories;

use GrahamCampbell\Credentials\Repositories\AbstractRepository;
use GrahamCampbell\Credentials\Repositories\PaginateRepositoryTrait;
use GrahamCampbell\Credentials\Repositories\SlugRepositoryTrait;

class PageRepository extends AbstractRepository
{
    use PaginateRepositoryTrait, SlugRepositoryTrait;
    // 同時擁有 paginate() 與 find() 方法
}

控制器中調用

public function show($slug)
{
    $page = PageRepository::find($slug);  // 來自 SlugRepositoryTrait
    $this->checkPage($page, $slug);
    return View::make('pages.show', ['page' => $page]);
}

Trait vs 繼承 vs 介面

命名衝突解決

use TraitA, TraitB {
    TraitA::method insteadof TraitB;  // 選擇 TraitA 版本
    TraitB::method as methodB;        // 別名引入 TraitB 版本
}

適用場景

• 跨領域關注點：日誌、快取、權限檢查
• 資料存取層通用查詢方法
• API 回應格式標準化
• 模型事件監聽器

設計原則

1. Trait 應專注單一職責
2. 避免過度使用導致類膨脹
3. 優先考慮組合而非繼承
4. 文檔說明 Trait 契約與依賴