PHP Trait 實現程式碼複用：解決單一繼承限制的最佳方案

PHP 5.4+ Trait 機制深度解析與實戰應用

PHP 單一繼承模型限制了程式碼複用的靈活性。自 PHP 5.4 引入 Trait 後，開發者得以在不使用繼承的情況下，將方法群組合入多個類別中。本文詳細說明 Trait 語法、衝突解決、優先順序與實際應用場景。

基本語法與使用

<?php

trait Loggable
{
    protected function log(string $message, string $level = 'info'): void
    {
        $time = date('Y-m-d H:i:s');
        echo "[$time] [$level] $message\n";
    }
}

trait Timestampable
{
    public function setCreatedAt(\DateTimeInterface $time): void
    {
        $this->createdAt = $time;
    }

    public function setUpdatedAt(\DateTimeInterface $time): void
    {
        $this->updatedAt = $time;
    }
}

class Article
{
    use Loggable, Timestampable;

    private \DateTimeInterface $createdAt;
    private \DateTimeInterface $updatedAt;

    public function publish(): void
    {
        $this->setCreatedAt(new \DateTimeImmutable());
        $this->log('文章發布', 'notice');
    }
}

$article = new Article();
$article->publish();
// 輸出: [2024-01-15 10:30:00] [notice] 文章發布

衝突解決與方法別名

當多個 Trait 定義相同方法名時，必須顯式解決：

<?php

trait A { public function hello() { echo 'A'; } }
trait B { public function hello() { echo 'B'; } }

class Test
{
    use A, B {
        B::hello insteadof A;  // 選用 B 的 hello
        A::hello as helloA;    // 將 A 的 hello 別名為 helloA
    }
}

$t = new Test();
$t->hello();  // 輸出 B
$t->helloA(); // 輸出 A

存取修飾符調整

<?php

trait InternalTools
{
    private function internalHelper(): string { return 'secret'; }
    protected function protectedHelper(): string { return 'protected'; }
}

class Service
{
    use InternalTools {
        internalHelper as public getSecret;   // 將 private 改為 public
        protectedHelper as public getProtected; // 將 protected 改為 public
    }
}

$svc = new Service();
echo $svc->getSecret();      // 可呼叫
echo $svc->getProtected();   // 可呼叫

Trait 中的屬性與抽象方法

<?php

trait Configurable
{
    // Trait 可定義屬性
    private array $config = [];

    // 可定義抽象方法，強制使用類別實作
    abstract protected function getDefaultConfig(): array;

    public function setConfig(array $config): void
    {
        $this->config = array_merge($this->getDefaultConfig(), $config);
    }

    public function getConfig(string $key, $default = null)
    {
        return $this->config[$key] ?? $default;
    }
}

class App
{
    use Configurable;

    protected function getDefaultConfig(): array
    {
        return ['debug' => false, 'env' => 'production'];
    }
}

$app = new App();
$app->setConfig(['debug' => true]);
var_dump($app->getConfig('debug')); // true

實戰應用場景

• 横切關注點：日誌、快取、事件發送、審計追蹤。
• 標準介面實作：ArrayAccess、Countable、Serializable 等介面的通用實作。
• 實體基礎功能：時間戳、軟刪除、UUID 生成、狀態機。
• 測試輔助：測試用的 Mock 行為、資料建構器。

注意事項與最佳實踐

1. 非實例化：Trait 不能單獨實例化，只能被類別 use。
2. 靜態成員獨立：每個使用 Trait 的類別擁有獨立的靜態屬性副本。
3. 避免過度使用：過多 Trait 組合會增加認知負擔，優先考慮組合模式。
4. 命名衝突：慎重命名 Trait 方法，善用 insteadof 與 as。
5. 型別提示：PHP 8.1+ 支援 Trait 中的 readonly 屬性與回傳型別。

Trait vs Interface vs Abstract Class