核心要點

• Drupal 8 從過程式編程轉(zhuǎn)向面向?qū)ο蠹軜?gòu)，并通過“Proudly Found Elsewhere”計劃整合了其他來源的代碼，其中包括 Symfony 組件等重要補充。
• 創(chuàng)建 Drupal 8 模塊需要定義必要的文件夾結(jié)構(gòu)和文件，例如 .info.yml 文件。自定義和貢獻模塊文件夾現(xiàn)在直接位于根目錄 modules/ 下，核心代碼則移動到單獨的 core/ 文件夾中。
• Drupal 8 中的“路由”取代了 Drupal 7 中的 hook_menu() 函數(shù)，利用 Symfony2 組件。這涉及到將路由定義為配置，并在控制器中處理回調(diào)函數(shù)。模塊的路由文件 demo.routing.yml 創(chuàng)建在模塊根文件夾中。
• 菜單鏈接不再通過 hook_menu() 處理，而是作為配置在 yml 文件中聲明。在模塊根目錄中創(chuàng)建名為 demo.menu_links.yml 的文件來定義菜單鏈接及其在站點現(xiàn)有菜單中的位置。

請注意，由于本文撰寫時 Drupal 8 仍在開發(fā)中，部分代碼可能已過時。請參考我嘗試更新示例代碼并使其與最新 Drupal 8 版本兼容的代碼庫。

Drupal 8 引入了許多變化，力求使其與其他現(xiàn)代 PHP 框架保持一致。這意味著舊的 PHP 4 風(fēng)格的過程式編程在很大程度上被面向?qū)ο蠹軜?gòu)所取代。為了實現(xiàn)這一點，在“Proudly Found Elsewhere”計劃下，Drupal 8 包含了并非專門為 Drupal 開發(fā)的代碼。

Drupal 最重要的補充之一是 Symfony 組件，這對 Drupal 開發(fā)人員帶來了兩大影響。首先，它有可能大大增加現(xiàn)在想要為 Drupal 開發(fā)的開發(fā)人員數(shù)量。其次，它讓一些缺乏現(xiàn)代 PHP 實踐經(jīng)驗的 Drupal 7 開發(fā)人員感到有些擔(dān)憂。但這沒關(guān)系，我們都在學(xué)習(xí)，從 Symfony（以及希望是 Drupal 8）等框架中吸取的經(jīng)驗，將很容易擴展并應(yīng)用于其他 PHP 框架。

與此同時，Drupal 8 處于其發(fā)布周期的后期階段，本文撰寫時的當(dāng)前版本為 alpha11。我們將使用此版本來展示 Drupal 7 開發(fā)人員首先會遇到并應(yīng)該熟悉的模塊開發(fā)的一些基本變化。我設(shè)置了一個 Git 代碼庫，您可以在其中找到我在本系列中編寫的代碼，如果您愿意，可以這樣跟隨學(xué)習(xí)。

如何創(chuàng)建一個模塊？

我們要首先關(guān)注的是定義必要的文件夾結(jié)構(gòu)和文件，以便讓 Drupal 8 了解我們的新模塊。在 Drupal 7 中，我們至少需要創(chuàng)建兩個文件（.info 和 .module），但在 Drupal 8 中，前者的 YAML 版本就足夠了。是的，.info 文件現(xiàn)在被 .info.yml 文件取代，包含類似的數(shù)據(jù)，但結(jié)構(gòu)不同。

另一個重大變化是，自定義和貢獻模塊文件夾現(xiàn)在直接進入根目錄 modules/ 文件夾。這是因為所有核心代碼都已移動到其自身的單獨 core/ 文件夾中。當(dāng)然，在 modules/ 目錄中，建議像在 Drupal 7 中一樣，將模塊分隔為自定義和貢獻。

讓我們創(chuàng)建一個名為 demo（非常原創(chuàng)）的模塊，并將其放在 modules/custom/ 目錄中。正如我提到的，在這個新創(chuàng)建的 demo/ 文件夾內(nèi)，我們首先只需要一個包含以下所需內(nèi)容的 demo.info.yml 文件：

name: Drupal 8 Demo module
description: 'Demo module for Drupal 8 alpha11'
type: module
core: 8.x

其中四個鍵值對中有三個你應(yīng)該很熟悉（name、description 和 core）。type 現(xiàn)在也是一個必需項，因為你也可以為主題創(chuàng)建 yml 文件。另一個需要注意的重要事項是，yml 文件中的空格是有意義的，并且使用正確的縮進將數(shù)據(jù)組織成類似數(shù)組的結(jié)構(gòu)。

您可以查看此文檔頁面，了解可以添加到模塊 .info.yml 文件中的其他鍵值對，以及宣布切換到此格式的更改說明。

就是這樣，一個文件。您現(xiàn)在可以導(dǎo)航到“擴展”頁面，找到 Demo 模塊并啟用它。

正如我提到的，在我們啟用模塊之前，不再需要創(chuàng)建 .module 文件。從架構(gòu)上講，.module 文件的大小將大大減小，因為大部分業(yè)務(wù)邏輯將移動到服務(wù)類、控制器和插件中，但我們稍后會看到其中的一些內(nèi)容。

什么是“路由”，hook_menu() 及其回調(diào)函數(shù)發(fā)生了什么？

在 Drupal 7 中，hook_menu() 可能是實現(xiàn)最多的鉤子，因為它用于定義 Drupal 的路徑并將這些路徑與回調(diào)函數(shù)連接起來。它還負責(zé)創(chuàng)建菜單鏈接和許多其他內(nèi)容。

在 Drupal 8 中，我們不再需要 hook_menu()，因為我們大量使用 Symfony2 組件來處理路由。這涉及到將路由定義為配置，并在控制器（控制器類的函數(shù)）中處理回調(diào)函數(shù)。讓我們看看如何通過創(chuàng)建一個輸出經(jīng)典 Hello world! 的簡單頁面來實現(xiàn)這一點。

首先，我們需要為我們的模塊創(chuàng)建一個名為 demo.routing.yml 的路由文件。此文件位于模塊根文件夾（與 demo.info.yml 相鄰）中。在這個文件中，我們可以有以下（簡單的）路由定義：

name: Drupal 8 Demo module
description: 'Demo module for Drupal 8 alpha11'
type: module
core: 8.x

第一行標(biāo)志著為模塊 demo 創(chuàng)建一個名為 demo 的新路由的開始（第一個是模塊名稱，第二個是路由名稱）。在 path 下，我們指定此路由要注冊的路徑。在 defaults 下，我們有兩件事：默認頁面標(biāo)題（_title）和 _content，它引用 DemoController 類上的一個函數(shù)。在 requirements 下，我們指定訪問用戶需要擁有的權(quán)限才能查看頁面。您應(yīng)該查閱此文檔頁面，了解此路由文件可以具有的更多選項。

現(xiàn)在，讓我們創(chuàng)建我們的第一個名為 DemoController 的控制器，當(dāng)用戶請求此頁面時，它將調(diào)用一個名為 demo() 的函數(shù)。

在模塊目錄中，創(chuàng)建一個名為 src/ 的文件夾，并在其中創(chuàng)建一個名為 Controller/ 的文件夾。這將是存儲控制器類的地方。繼續(xù)創(chuàng)建第一個：DemoController.php。

控制器以及我們稍后將看到的其他類的放置到 src/ 文件夾中是采用 PSR-4 標(biāo)準(zhǔn)的一部分。最初，我們必須創(chuàng)建一個更大的文件夾結(jié)構(gòu)（PSR-0 標(biāo)準(zhǔn)），但現(xiàn)在有一個過渡階段，兩者都可以工作。因此，如果您仍然看到放置在名為 lib/ 的文件夾中的代碼，那就是 PSR-0。

在我們的 DemoController.php 文件中，我們現(xiàn)在可以聲明我們的類：

demo.demo:
  path: '/demo'
  defaults:
    _content: '\Drupal\demo\Controller\DemoController::demo'
    _title: 'Demo'
  requirements:
    _permission: 'access content'

這是為了在頁面上顯示某些內(nèi)容而需要做的最簡單和最少的事情。在頂部，我們指定類命名空間，在下面我們聲明類。

在 DemoController 類中，我們只有 demo() 函數(shù)，它返回一個類似 Drupal 7 的可渲染數(shù)組。沒什么大不了的。我們現(xiàn)在所要做的就是清除緩存并導(dǎo)航到 http://www.miracleart.cn/link/1a4a5f89e71e4bb9973355c964a950b4 Drupal 頁面，上面打印著Hello World。

菜單鏈接呢？

在 Drupal 7 中，當(dāng)我們實現(xiàn) hook_menu() 時，我們還可以將注冊的路徑添加到菜單中，以便在站點上顯示菜單鏈接。這再次不再使用此鉤子處理，而是使用 yml 文件將菜單鏈接定義為配置。

讓我們看看如何創(chuàng)建一個顯示在管理的“結(jié)構(gòu)”菜單下的菜單鏈接。首先，我們需要在模塊的根目錄中創(chuàng)建一個名為 demo.menu_links.yml 的文件。在這個 yml 文件中，我們將定義菜單鏈接及其在站點現(xiàn)有菜單中的位置。為了實現(xiàn)我們設(shè)定的目標(biāo)，我們需要以下內(nèi)容：

<?php
/**
 * @file
 * Contains \Drupal\demo\Controller\DemoController.
 */

namespace Drupal\demo\Controller;

/**
 * DemoController.
 */
class DemoController {
  /**
   * Generates an example page.
   */
  public function demo() {
    return array(
      '#markup' => t('Hello World!'),
    );
  }
}

我們再次有一個基于縮進的 yml 結(jié)構(gòu)，我們首先為模塊 demo 定義菜單鏈接的機器名稱（demo）（就像我們對路由所做的那樣）。接下來，我們有鏈接標(biāo)題和說明，然后是此鏈接的父級（它應(yīng)該放置的位置）以及它應(yīng)該使用什么路由。

parent 的值是父菜單鏈接（附加其模塊），要找到它，您需要在 *.menu_links.yml 文件中進行一些挖掘。我知道“結(jié)構(gòu)”鏈接是在核心系統(tǒng)模塊中定義的，因此通過查看 system.menu_links.yml 文件，我可以確定此鏈接的名稱。

route_name 是我們要為此鏈接使用的路由的機器名稱。我們之前定義了我們的。有了這個，您可以清除緩存并導(dǎo)航到 http://www.miracleart.cn/link/6c2665d7c3ed1e5bfd8ba600f026eb55 demo/ 路徑。不錯。

結(jié)論

在本文中，我們開始探索 Drupal 8 中的模塊開發(fā)。在這個階段（alpha11 版本），是時候開始學(xué)習(xí)如何使用新的 API 和移植貢獻模塊了。為此，我正在書寫我對這個新的令人興奮的框架（Drupal 8）的探索，以便我們都能學(xué)習(xí)這些變化，并在發(fā)布日到來時立即投入工作。

首先，我們了解了一些基礎(chǔ)知識：如何啟動 Drupal 8 模塊（文件、文件夾結(jié)構(gòu)等），并將其與 Drupal 7 進行比較。我們還了解了如何定義路由和一個控制器類，以及如何通過此路由調(diào)用一個函數(shù)。最后，我們看到了如何創(chuàng)建一個使用我們定義的路由的菜單鏈接。

在下一個教程中，我們將繼續(xù)構(gòu)建此模塊，并了解 Drupal 8 使用的其他一些很酷的新功能。我們將了解如何創(chuàng)建塊以及如何使用表單和配置系統(tǒng)。到時候見。

關(guān)于構(gòu)建 Drupal 8 模塊的常見問題解答 (FAQ)

Drupal 8 模塊的基本結(jié)構(gòu)是什么？

Drupal 8 模塊本質(zhì)上是一組包含某些功能的文件，并以特定方式構(gòu)建。基本結(jié)構(gòu)包括一個 .info.yml 文件（提供有關(guān)模塊的元數(shù)據(jù)）、一個 .module 文件（包含 PHP 代碼）以及其他可選文件，例如 .css、.js、.twig 等，用于附加功能。.info.yml 文件是強制性的，它定義了模塊的名稱、描述、包、類型、核心和依賴項。

Drupal 8 中的路由系統(tǒng)如何工作？

Drupal 8 中的路由系統(tǒng)負責(zé)將 URL 映射到特定的控制器類。它使用 Symfony 的路由組件，該組件允許靈活且強大的系統(tǒng)。路由系統(tǒng)使用 routing.yml 文件來定義具有唯一名稱、路徑、默認值和要求的路由。默認值通常指定負責(zé)處理請求的控制器類。

如何在 Drupal 8 中創(chuàng)建自定義頁面？

在 Drupal 8 中創(chuàng)建自定義頁面涉及定義路由和控制器。路由在 routing.yml 文件中定義，并將 URL 映射到控制器?？刂破魇且粋€ PHP 類，它為頁面內(nèi)容返回一個渲染數(shù)組?？刂破黝悜?yīng)放在模塊的 src/Controller 目錄中。

如何在我的 Drupal 8 自定義頁面中添加菜單鏈接？

將菜單鏈接添加到您的自定義頁面涉及在您的模塊中創(chuàng)建一個 links.menu.yml 文件。此文件定義了菜單鏈接，其屬性包括標(biāo)題、描述、父級、路由名稱和權(quán)重。路由名稱應(yīng)與 routing.yml 文件中定義的路由名稱匹配。

如何在 Drupal 8 中創(chuàng)建表單？

在 Drupal 8 中創(chuàng)建表單涉及創(chuàng)建一個擴展 FormBase 類并實現(xiàn) FormInterface 的表單類。此類定義表單元素、驗證和提交處理?？梢酝ㄟ^從控制器返回表單來顯示表單。

如何在 Drupal 8 中創(chuàng)建塊？

在 Drupal 8 中創(chuàng)建塊涉及創(chuàng)建一個擴展 BlockBase 類的塊類。此類定義塊內(nèi)容和其他屬性?？梢酝ㄟ^塊布局界面將塊放置在頁面上。

如何在 Drupal 8 中創(chuàng)建配置表單？

創(chuàng)建配置表單涉及創(chuàng)建一個擴展 ConfigFormBase 類并實現(xiàn) FormInterface 的表單類。此類定義表單元素并處理配置數(shù)據(jù)的保存和加載。

如何在 Drupal 8 中創(chuàng)建管理頁面？

創(chuàng)建管理頁面涉及定義一條路徑在 /admin 下的路由和一個返回頁面內(nèi)容的渲染數(shù)組的控制器?？梢酝ㄟ^定義一個在 system.admin 下具有父級的菜單鏈接將頁面添加到管理菜單中。

如何在 Drupal 8 中創(chuàng)建主題？

在 Drupal 8 中創(chuàng)建主題涉及創(chuàng)建一個 .info.yml 文件，該文件定義名稱、描述、類型、核心和基本主題。可以添加其他 .twig、.css 和 .js 文件來為各個元素設(shè)置主題。

如何在 Drupal 8 中創(chuàng)建自定義字段類型？

創(chuàng)建自定義字段類型涉及創(chuàng)建一個擴展 FieldTypePluginBase 類的字段類型類。此類定義字段屬性以及用于存儲、顯示和表單處理的方法。字段類型可用于內(nèi)容類型、用戶、評論和其他實體。

以上是構(gòu)建Drupal 8模塊：路由，控制器和菜單鏈接的詳細內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！