本文探討如何構(gòu)建一個(gè)簡(jiǎn)單的依賴注入容器（DI 容器）PHP 包。文中所有代碼，包括 PHPDoc 注解和單元測(cè)試（100% 代碼覆蓋率），都已上傳至 GitHub 倉(cāng)庫(kù)，并在 Packagist 上列出。

關(guān)鍵要點(diǎn):

• 構(gòu)建 DI 容器有助于開發(fā)者理解依賴注入的基本原理和容器的工作機(jī)制。
• DI 容器主要有兩個(gè)作用：“依賴注入”和“容器”。它需要能夠使用構(gòu)造器注入或設(shè)置器注入方法來實(shí)例化和包含服務(wù)。
• Symfony 依賴注入容器可作為創(chuàng)建自定義容器的參考。它將容器配置分為參數(shù)和服務(wù)，允許安全存儲(chǔ)應(yīng)用程序密鑰。
• 創(chuàng)建 DI 容器涉及創(chuàng)建項(xiàng)目目錄、創(chuàng)建 composer.json 文件以及實(shí)現(xiàn)容器互操作接口。它還涉及創(chuàng)建異常和引用類。
• 容器類需要包含用于檢索服務(wù)、檢查服務(wù)是否已定義、解析參數(shù)和初始化服務(wù)的方法。它還應(yīng)該具有防止循環(huán)引用的保護(hù)機(jī)制。

規(guī)劃我們的依賴注入容器

首先，我們將“依賴注入容器”拆分為兩個(gè)角色：“依賴注入”和“容器”。

依賴注入最常用的兩種方法是構(gòu)造器注入和設(shè)置器注入，即通過構(gòu)造器參數(shù)或方法調(diào)用傳遞類依賴項(xiàng)。如果我們的容器能夠?qū)嵗桶?wù)，則它需要能夠執(zhí)行這兩種操作。

要成為一個(gè)容器，它必須能夠存儲(chǔ)和檢索服務(wù)的實(shí)例。與創(chuàng)建服務(wù)相比，這是一個(gè)相當(dāng)簡(jiǎn)單的任務(wù)，但仍然值得考慮。container-interop 包提供了一組容器可以實(shí)現(xiàn)的接口。主要接口是 ContainerInterface，它定義了兩種方法：一種用于檢索服務(wù)，另一種用于測(cè)試服務(wù)是否已定義。

interface ContainerInterface
{
    public function get($id);
    public function has($id);
}

學(xué)習(xí)其他依賴注入容器

Symfony 依賴注入容器允許我們通過多種不同方式定義服務(wù)。在 YAML 中，容器的配置可能如下所示：

parameters:
    # ...
    mailer.transport: sendmail

services:
    mailer:
        class:     Mailer
        arguments: ["%mailer.transport%"]
    newsletter_manager:
        class:     NewsletterManager
        calls:
            - [setMailer, ["@mailer"]]

Symfony 將容器配置分為參數(shù)和服務(wù)的配置方式非常有用。這允許將 API 密鑰、加密密鑰和身份驗(yàn)證令牌等應(yīng)用程序密鑰存儲(chǔ)在從源代碼存儲(chǔ)庫(kù)中排除的參數(shù)文件中。

在 PHP 中，Symfony 依賴注入組件的相同配置如下所示：

use Symfony\Component\DependencyInjection\Reference;

// ...
$container->setParameter('mailer.transport', 'sendmail');

$container
    ->register('mailer', 'Mailer')
    ->addArgument('%mailer.transport%');

$container
    ->register('newsletter_manager', 'NewsletterManager')
    ->addMethodCall('setMailer', array(new Reference('mailer')));

通過在對(duì) setMailer 的方法調(diào)用中使用 Reference 對(duì)象，依賴注入邏輯可以檢測(cè)到此值不應(yīng)直接傳遞，而應(yīng)替換為它在容器中引用的服務(wù)。這允許輕松地將 PHP 值和其他服務(wù)注入服務(wù)而不會(huì)造成混淆。

開始

首先，創(chuàng)建一個(gè)新的項(xiàng)目目錄并創(chuàng)建一個(gè) composer.json 文件，Composer 可以使用該文件自動(dòng)加載我們的類。目前，此文件只將 SitePointContainer 命名空間映射到 src 目錄。

interface ContainerInterface
{
    public function get($id);
    public function has($id);
}

接下來，因?yàn)槲覀儗⑹刮覀兊娜萜鲗?shí)現(xiàn)容器互操作接口，我們需要使 Composer 下載它們并將它們添加到我們的 composer.json 文件中：

parameters:
    # ...
    mailer.transport: sendmail

services:
    mailer:
        class:     Mailer
        arguments: ["%mailer.transport%"]
    newsletter_manager:
        class:     NewsletterManager
        calls:
            - [setMailer, ["@mailer"]]

除了主要的 ContainerInterface 之外，container-interop 包還定義了兩個(gè)異常接口。第一個(gè)用于創(chuàng)建服務(wù)時(shí)遇到的常規(guī)異常，另一個(gè)用于請(qǐng)求的服務(wù)找不到時(shí)。我們還將向此列表中添加另一個(gè)異常，用于請(qǐng)求的參數(shù)找不到時(shí)。

(以下內(nèi)容省略了代碼實(shí)現(xiàn)部分，因?yàn)槠^長(zhǎng)，且核心邏輯已在上文中描述。 GitHub 倉(cāng)庫(kù)中的完整代碼包含了異常類、引用類和容器類的完整實(shí)現(xiàn)。)

總結(jié)

我們學(xué)習(xí)了如何創(chuàng)建一個(gè)簡(jiǎn)單的依賴注入容器，但是還有很多其他容器具有我們尚未實(shí)現(xiàn)的強(qiáng)大功能！

一些依賴注入容器，例如 PHP-DI 和 Aura.Di，提供了一個(gè)稱為自動(dòng)裝配的功能。在這里，容器會(huì)猜測(cè)容器中的哪些服務(wù)應(yīng)該注入到其他服務(wù)中。為此，它們使用反射 API 來查找有關(guān)構(gòu)造器參數(shù)的信息。

您可以隨意派生該倉(cāng)庫(kù)并添加自動(dòng)裝配等功能，這是一個(gè)很好的練習(xí)！此外，我們保留了一個(gè)公共列表，其中列出了此容器的所有已知派生版本，以便其他人可以看到您所做的工作。只需使用下面的評(píng)論與我們分享您的工作，我們將確保將其添加進(jìn)去。

您也可以使用下面的評(píng)論與我們聯(lián)系。讓我們知道您想澄清或解釋的內(nèi)容，或者您發(fā)現(xiàn)的任何錯(cuò)誤。

(以下內(nèi)容省略了 FAQs 部分，因?yàn)槠鋬?nèi)容與上文高度重復(fù)，且篇幅過長(zhǎng)。)

以上是如何構(gòu)建自己的依賴注入容器的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！