核心要點

• Drupal 8 的 ConfigFormBase 類提供了額外的功能來與配置系統(tǒng)交互，允許將表單轉(zhuǎn)換為存儲值的工具。這可以通過用 ConfigFormBase 替換擴(kuò)展類並在表單中進(jìn)行必要的更改來實現(xiàn)。 Drupal 8 中的配置存儲在 YAML 文件中，可以通過 UI 進(jìn)行更改，以便跨不同站點部署。
• Drupal 8 中的服務(wù)容器允許創(chuàng)建服務(wù)，即執(zhí)行全局操作的 PHP 類，並將其註冊到服務(wù)容器中以供訪問。依賴注入用於將對像傳遞給其他對象，確保解耦?？梢酝ㄟ^在模塊的根目錄中創(chuàng)建 demo.services.yml 文件來註冊服務(wù)。
• Drupal 8 中的依賴注入是一種設(shè)計模式，允許一個對象提供另一個對象的依賴項，使代碼更模塊化且更易於測試。這可以通過擴(kuò)展 ControllerBase 類或?qū)崿F(xiàn) ContainerInjectionInterface 來實現(xiàn)。還可以使用 Drupal 類全局訪問服務(wù)。

請注意，由於撰寫本文時 Drupal 8 正在進(jìn)行開發(fā)過程，因此某些代碼部分可能已過時。請查看此存儲庫，我嘗試更新示例代碼並使其與最新的 Drupal 8 版本兼容。

在之前的關(guān)於 Drupal 8 模塊開發(fā)的文章中，我們研究了創(chuàng)建塊類型和表單。我們已經(jīng)看到塊現(xiàn)在是可重用的，以及定義塊類型所需的一切都在一個類中完成。類似地，表單生成函數(shù)也分組在一個類中，其中特定方法執(zhí)行的任務(wù)類似於我們在 Drupal 7 中習(xí)慣的任務(wù)。

在本教程中，我將從我們上次結(jié)束的地方繼續(xù)。我將說明如何將我們的 DemoForm 轉(zhuǎn)換為用於通過 Drupal 8 配置系統(tǒng)存儲值的表單。之後，我們將通過示例說明服務(wù)容器和依賴注入。

別忘了，如果您想獲取本教程系列中編寫的全部代碼，可以查看此存儲庫。

配置表單

當(dāng)我們第一次定義 DemoForm 時，我們擴(kuò)展了 FormBase 類，這是 FormInterface 的最簡單實現(xiàn)。但是，Drupal 8 還附帶了一個 ConfigFormBase，它提供了一些附加功能，使與配置系統(tǒng)交互變得非常容易。

我們現(xiàn)在要做的是將 DemoForm 轉(zhuǎn)換為一個用於存儲用戶輸入的電子郵件地址的表單。我們應(yīng)該做的第一件事是用 ConfigFormBase 替換擴(kuò)展類（當(dāng)然還要 use 它）：

use Drupal\Core\Form\ConfigFormBase;

class DemoForm extends ConfigFormBase {

在我們繼續(xù)更改表單中的其他內(nèi)容之前，讓我們了解一下 Drupal 8 中的簡單配置是如何工作的。我說“簡單”，因為還有更複雜的配置實體，我們今天不會介紹。就目前而言，模塊（核心或 contrib）提供的配置存儲在 YAML 文件中。啟用模塊後，此數(shù)據(jù)將導(dǎo)入到數(shù)據(jù)庫中（以便在使用時提高性能）。通過 UI，我們可以更改此配置，然後可以輕鬆地將其導(dǎo)出到 YAML 文件中，以便跨不同站點部署。

模塊可以在模塊根目錄的 config/install 文件夾中提供一個 YAML 文件中的默認(rèn)配置。此文件的命名約定是在其前面加上模塊的名稱。因此，讓我們創(chuàng)建一個名為 demo.settings.yml 的文件。在這個文件中，讓我們粘貼以下內(nèi)容：

demo:
  email_address: demo@demo.com

這是一個嵌套結(jié)構(gòu)（就像 PHP 中的關(guān)聯(lián)數(shù)組）。在 demo 鍵下，我們有另一個鍵值對。通常，要訪問這些嵌套值，我們使用點 (.)。在我們的例子中是 demo.email_address。

一旦我們有了這個文件，你需要記住的一件重要事情是，只有在安裝模塊時才會導(dǎo)入此文件。因此，繼續(xù)重新安裝它?，F(xiàn)在我們可以回到我們的表單並逐一查看需要調(diào)整的方法。

這就是 buildForm() 方法現(xiàn)在的樣子：

public function buildForm(array $form, array &$form_state) {

  $form = parent::buildForm($form, $form_state);

  $config = $this->config('demo.settings');

  $form['email'] = array(
    '#type' => 'email',
    '#title' => $this->t('Your .com email address.'),
    '#default_value' => $config->get('demo.email_address')
  );

  return $form;
}

首先，與 FormBase 相反，ConfigFormBase 類也實現(xiàn)了此方法，以便向表單數(shù)組（提交按鈕）添加元素。因此，在添加我們自己的元素之前，我們可以使用父類之前所做的操作。

現(xiàn)在對於配置部分。 Drupal 8 提供了一個 Config 對象，我們可以用它來與配置交互。某些類已經(jīng)通過依賴注入獲得了它。 ConfigFormBase 就是這樣一個類。

如您所見，我們正在使用父類的 config() 方法來檢索一個 Config 對象，該對像已填充我們的 demo.settings 簡單配置。然後，對於電子郵件表單元素的 #default_value，我們使用 Config 對象的 get() 方法來檢索電子郵件地址的值。

接下來，我們只需要更改提交處理程序，因為 validateForm() 方法現(xiàn)在可以保持不變：

public function submitForm(array &$form, array &$form_state) {

  $config = $this->config('demo.settings');
  $config->set('demo.email_address', $form_state['values']['email']);
  $config->save();

  return parent::submitForm($form, $form_state);
}

在此方法中，我們首先檢索我們配置的 Config 對象（就像我們之前做的那樣）。然後，我們使用它的 set() 方法將 email_address 的值更改為用戶提交的值。然後我們使用 save() 方法保存配置。最後，我們擴(kuò)展了父提交處理程序，因為它確實包含一些功能（在這種情況下，它會將 Drupal 消息設(shè)置為屏幕）。

就是這樣。您可以清除緩存並試一試。通過提交一個新的電子郵件地址，您將其存儲在配置中。 demo.settings.yml 文件當(dāng)然不會更改，但是您可以去導(dǎo)出 demo.settings 配置並將其導(dǎo)入到另一個站點。

服務(wù)容器和依賴注入

接下來我們要看的是服務(wù)容器。服務(wù)背後的理念是將功能分解成可重用的組件。因此，服務(wù)是一個執(zhí)行某些全局操作並註冊到服務(wù)容器以便訪問的 PHP 類。

依賴注入是我們傳遞對像以確保解耦的方式。每個服務(wù)都需要處理一件事情，如果它需要另一個服務(wù)，則後者可以注入到前者中。但我們馬上就會看到如何操作。

接下來，我們將創(chuàng)建一個非常簡單的服務(wù)並將其註冊到容器中。它只有一個真正的返回簡單值的方法。然後，我們將該服務(wù)作為依賴項注入到我們的 DemoController 中並使用服務(wù)提供的值。

為了註冊服務(wù)，我們需要創(chuàng)建一個位於模塊根目錄的 demo.services.yml 文件，其內(nèi)容如下：

use Drupal\Core\Form\ConfigFormBase;

class DemoForm extends ConfigFormBase {

文件命名約定是 module_name.services.yml。

第一行創(chuàng)建了一個服務(wù)數(shù)組。第二行定義了第一個服務(wù)（稱為 demo_service，以模塊名稱為前綴）。第三行指定將為此服務(wù)實例化的類。接下來是在我們模塊的 src/ 文件夾中創(chuàng)建 DemoService.php 類文件。這就是我的服務(wù)所做的（實際上什麼也沒有，只是為了說明如何使用它）：

demo:
  email_address: demo@demo.com

這裡不需要解釋任何內(nèi)容，因為它非常基礎(chǔ)。接下來，讓我們轉(zhuǎn)向我們的 DemoController 並使用此服務(wù)。我們可以通過兩種方式做到這一點：通過 Drupal 類全局訪問容器或使用依賴注入將此類的對像傳遞給我們的控制器。最佳實踐建議我們應(yīng)該採用第二種方式，所以這就是我們將要做的。但有時您需要全局訪問服務(wù)。為此，您可以執(zhí)行以下操作：

public function buildForm(array $form, array &$form_state) {

  $form = parent::buildForm($form, $form_state);

  $config = $this->config('demo.settings');

  $form['email'] = array(
    '#type' => 'email',
    '#title' => $this->t('Your .com email address.'),
    '#default_value' => $config->get('demo.email_address')
  );

  return $form;
}

現(xiàn)在 $service 是我們剛剛創(chuàng)建的 DemoService 類的對象。但是讓我們看看如何在 DemoController 類中將我們的服務(wù)作為依賴項注入。我將首先解釋需要做什麼，然後您將看到包含所有對其進(jìn)行的更改的完整控制器。

首先，我們需要訪問服務(wù)容器。對於控制器來說，這非常容易。我們可以擴(kuò)展 ControllerBase 類，這除了其他一些幫助程序之外還給我們提供了這一點?；蛘撸覀兊目刂破骺梢詫崿F(xiàn) ContainerInjectionInterface，這也可以讓我們訪問容器。但是我們將堅持使用 ControllerBase，因此我們需要 use 該類。

接下來，我們需要 use Symfony 2 ContainerInterface 作為 create() 方法的要求，該方法實例化控制器的另一個對象並將我們想要的服務(wù)傳遞給它。

最後，我們將需要一個構(gòu)造函數(shù)來獲取傳遞的服務(wù)對象（create() 返回的對象）並將它們分配給屬性以供以後使用。 create() 方法返回對象的順序需要反映它們傳遞給構(gòu)造函數(shù)的順序。

因此，讓我們看看我們修改後的 DemoController：

use Drupal\Core\Form\ConfigFormBase;

class DemoForm extends ConfigFormBase {

如您所見，所有步驟都在這裡。 create() 方法創(chuàng)建了我們控制器類的新實例，並將從容器檢索的服務(wù)傳遞給它。最後，DemoService 類的實例存儲在 $demoService 屬性中，我們可以使用它來調(diào)用其 getDemoValue() 方法。然後，此值將用於“Hello”消息中。清除緩存並試一試。轉(zhuǎn)到 demo/ 路徑，您應(yīng)該看到頁面上打印的“Hello Upchuk！”。

我相信您可以看到服務(wù)容器的強(qiáng)大功能，因為我們現(xiàn)在可以編寫解耦的功能並將其傳遞到需要的地方。我沒有向您展示如何操作，但是您也可以在註冊服務(wù)時聲明依賴項。這意味著當(dāng) Drupal 實例化服務(wù)對象時，它也將為其所有依賴項這樣做，並將它們傳遞給其構(gòu)造函數(shù)。您可以在此文檔頁面上閱讀有關(guān)如何執(zhí)行此操作的更多信息。

結(jié)論

在本文中，我們研究了很多很酷的東西。我們已經(jīng)看到了配置系統(tǒng)如何管理簡單的配置以及為此提供的哪些“表單”功能。我鼓勵您探索 ConfigFormBase 的實現(xiàn)方式以及擴(kuò)展它時可用的功能。此外，您應(yīng)該在 UI 中使用在站點之間導(dǎo)入/導(dǎo)出配置進(jìn)行練習(xí)。從現(xiàn)在開始，這將是對部署過程的一大改進(jìn)。

然後，我們研究了服務(wù)、它們是什麼以及它們?nèi)绾喂ぷ?。一種維護(hù)可重用且解耦的功能塊的好方法，這些功能塊可從任何地方訪問。我希望依賴注入的概念不再那麼可怕（如果它對您來說是的話）。它基本上等同於將參數(shù)傳遞給過程函數(shù)，但由 Symfony 及其強(qiáng)大的服務(wù)容器在幕後使用構(gòu)造函數(shù)方法（或 setter）完成。

關(guān)於構(gòu)建 Drupal 8 模塊的常見問題：配置管理和服務(wù)容器

服務(wù)容器在 Drupal 8 中的作用是什麼？

Drupal 8 中的服務(wù)容器是一個關(guān)鍵組件，用於管理服務(wù)的創(chuàng)建，服務(wù)是在 Drupal 應(yīng)用程序中全局使用的對象。它確保每個服務(wù)只實例化一次，從而節(jié)省內(nèi)存並提高性能。服務(wù)容器還處理依賴注入，這是一種設(shè)計模式，允許一個對象提供另一個對象的依賴項。這使代碼更模塊化、更易於測試並促進(jìn)更好的組織。

如何在 Drupal 8 中定義新服務(wù)？

要在 Drupal 8 中定義新服務(wù)，您需要在模塊的根目錄中創(chuàng)建一個 services.yml 文件。此文件應(yīng)包含服務(wù)的名稱、類和參數(shù)。該類應(yīng)是實現(xiàn)服務(wù)的類的完全限定名稱，參數(shù)應(yīng)為服務(wù)所依賴的任何服務(wù)或參數(shù)。

Drupal 8 中的配置管理的目的是什麼？

Drupal 8 中的配置管理是一個系統(tǒng)，允許您以一致的方式管理站點配置數(shù)據(jù)。它使您可以導(dǎo)入、導(dǎo)出和同步配置數(shù)據(jù)，這在將配置更改從開發(fā)環(huán)境移動到生產(chǎn)站點時非常有用。它還提供了一種跟蹤和管理站點配置隨時間推移的變化的方法。

如何使用配置管理系統(tǒng)導(dǎo)出和導(dǎo)入配置數(shù)據(jù)？

要在 Drupal 8 中導(dǎo)出配置數(shù)據(jù)，您可以使用管理面板中的配置管理界面或使用 Drush 命令。導(dǎo)出的數(shù)據(jù)將採用 YAML 格式，可以輕鬆讀取和編輯。要導(dǎo)入配置數(shù)據(jù)，您可以通過配置管理界面上傳導(dǎo)出的 YAML 文件或使用 Drush 命令。請記住，在導(dǎo)入配置數(shù)據(jù)之前備份您的站點，以防止任何潛在的數(shù)據(jù)丟失。

什麼是依賴注入，為什麼它在 Drupal 8 中很重要？

依賴注入是一種設(shè)計模式，允許一個對象提供另一個對象的依賴項。在 Drupal 8 中，它用於使服務(wù)和控制器更模塊化且更易於測試。不是在對象內(nèi)部創(chuàng)建依賴項，而是通過構(gòu)造函數(shù)或 setter 方法傳遞（注入）它們。這使代碼更易於測試、更靈活且耦合度更低。

如何在我的 Drupal 8 服務(wù)中註入依賴項？

要在 Drupal 8 中的服務(wù)中註入依賴項，您需要在 services.yml 文件中服務(wù)的定義中定義它們。依賴項應(yīng)列在 arguments 鍵下。創(chuàng)建服務(wù)時，服務(wù)容器將自動將這些依賴項傳遞給服務(wù)的構(gòu)造函數(shù)。

Drupal 8 中的服務(wù)和插件有什麼區(qū)別？

在 Drupal 8 中，服務(wù)是一個執(zhí)行應(yīng)用程序中全局任務(wù)的對象，而插件是一個以可插入方式執(zhí)行特定任務(wù)的對象。服務(wù)在 services.yml 文件中定義，並由服務(wù)容器管理，而插件由插件管理器發(fā)現(xiàn)和實例化。

如何在 Drupal 8 中覆蓋服務(wù)？

要在 Drupal 8 中覆蓋服務(wù)，您需要在模塊的 services.yml 文件中定義一個與要覆蓋的服務(wù)同名的服務(wù)。您的新服務(wù)應(yīng)擴(kuò)展原始服務(wù)的類並覆蓋要更改的方法。

如何使用配置管理系統(tǒng)跟蹤站點配置的更改？

Drupal 8 中的配置管理系統(tǒng)提供了一種通過配置快照系統(tǒng)跟蹤站點配置更改的方法。每當(dāng)您導(dǎo)入或同步配置數(shù)據(jù)時，此系統(tǒng)都會對站點的活動配置進(jìn)行快照。然後，您可以比較這些快照以查看進(jìn)行了哪些更改。

services.yml 文件在 Drupal 8 中的作用是什麼？

Drupal 8 中的 services.yml 文件是定義模塊服務(wù)的場所。每個服務(wù)都使用唯一的名稱、實現(xiàn)服務(wù)的類的完全限定名稱以及服務(wù)所依賴的任何服務(wù)或參數(shù)來定義。 services.yml 文件由服務(wù)容器讀取，服務(wù)容器管理服務(wù)的創(chuàng)建和注入。

以上是Drupal 8模塊 - 配置管理和服務(wù)容器的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！