Day 18：依賴注入與新舊實作並存

2026 iThome 鐵人賽

DAY 18

Software Development

重新認識主幹開發（Trunk-Based Development）系列第 18 篇

18th鐵人賽

Miles

2026-10-02 23:10:07

17 瀏覽

分享至

建立共同介面後，新舊類別可以提供相同的操作，但呼叫端如果仍直接建立某個類別，切換時就得逐一修改。為了讓呼叫端不必隨著實作切換而修改，可以改由外部建立物件，再傳給呼叫端使用，這個做法稱為依賴注入（Dependency Injection）。

以下延續 Nathan 團隊的寄信改版情境。Mandy 已抽出 Sender 介面，原本的 ImmediateSender 仍照常寄信；Brent 則在準備背景寄送需要的環境。

透過建構子注入依賴

以準備客戶通知信的 CustomerNotifier 為例，原本的程式直接建立 ImmediateSender：

namespace App\Services;

use App\Mail\ImmediateSender;
use App\Mail\NotificationMail;

final class CustomerNotifier
{
    public function notify(string $email, string $text): void
    {
        $sender = new ImmediateSender();
        // NotificationMail 是這個案例使用的通知信類別，負責主旨與內容。
        $sender->send($email, new NotificationMail($text));
    }
}

原本的類別關係如下：

CustomerNotifier 是自己建立出 ImmediateSender 物件，所以即使寫好新的寄信類別，只要 CustomerNotifier 程式不修改，它建立的一樣還是 ImmediateSender 物件。

要讓 CustomerNotifier 換用其他寄信類別時不必修改程式，可以把建立物件的動作移到外部，改由建構子接收 Sender 介面的物件。之後只要傳入另一個符合約定的實作，就能換用不同的寄信方式。

調整後的 app/Services/CustomerNotifier.php 如下：

namespace App\Services;

use App\Mail\NotificationMail;
use App\Mail\Sender;

final class CustomerNotifier
{
    public function __construct(private Sender $sender)
    {
    }

    public function notify(string $email, string $text): void
    {
        $this->sender->send($email, new NotificationMail($text));
    }
}

改用建構子注入後，類別關係如下：

設定容器綁定

接著以 Laravel 的服務容器設定 Sender 對應的實作，讓容器建立物件並傳入建構子。在既有 AppServiceProvider 匯入對應類別，於 register() 方法加入以下綁定：

use App\Mail\ImmediateSender;
use App\Mail\Sender;

public function register(): void
{
    $this->app->bind(Sender::class, ImmediateSender::class);
}

這份綁定表示，需要 Sender 時就提供 ImmediateSender。

取得通知物件的程式也改由容器建立：

$notifier = app(\App\Services\CustomerNotifier::class);
$notifier->notify($email, $text);

通知功能仍使用原本的寄信方式，之後可以透過容器綁定切換實作。

調整 CustomerNotifier 的建構子時，建立它的程式也要一起改成由容器取得物件。確認這個通知功能仍能正常寄信後，就可以整合到主幹。

其他通知功能可以分批採用相同做法，不必一次全部改完。不過，仍直接建立 ImmediateSender 的功能不會跟著容器綁定切換，因此切換前要完成這些調整。

實作佇列寄送

新增 app/Mail/DomainQueueSender.php，實作 Sender 介面，依收件網域決定寄送方式：

namespace App\Mail;

use Illuminate\Mail\Mailable;
use Illuminate\Support\Facades\Mail;

final class DomainQueueSender implements Sender
{
    public function send(string $email, Mailable $message): void
    {
        $domain = strtolower(substr(strrchr($email, '@'), 1));

        if ($domain === 'example.net') {
            Mail::to($email)->queue($message);
            return;
        }

        Mail::to($email)->send($message);
    }
}

符合條件時，改用 queue() 將信件排入佇列；其餘情況仍使用 send() 立即寄送。

類別名稱直接說明差異：ImmediateSender 在當下執行寄送，DomainQueueSender 依網域選擇是否排入佇列。如果只叫做 OldSender、NewSender，接手的人還要先了解這次改版，才知道兩者分別做什麼。