Drupal LMS 內部拆解：架構、實體與開發者體驗

真實部署跑在甚麼之上

Drupal LMS 的參考開發技術棧刻意選得平淡無奇——而這正是它容易請到人、在香港又平宜的原因：

Drupal LMS 1.2.4 於 2026年 10 月 7 日發布，受 Drupal 保安公告政策保障，即穩定版本可獲協調式保安應對。項目由 Tag1 Consulting 維護，American Federation of Teachers 提供初期及持續開發，並報告有 208 個匯報網站。

實體模型

Drupal LMS 建基於 Drupal 以設定驅動的實體系統，這正是它模組化的原因：所有東西都是「基礎實體類型 ＋ 設定」的組合。

狀態實體正是 Drupal LMS 把進度追蹤做成建模層級概念的原因。進度是作為數據被記錄，而不是從報表反推——因此一名學生三年的紀錄可以直接查詢，不需要任何供應商專屬的匯出格式。

activity 類型與它們的許可範圍

activity 類型是 lms_activity 的各種組合。公開的類型集覆蓋了相當廣泛的評核範圍：

• select_single——單選題
• select_multiple——多選題
• true_false——對錯題
• free_text——文字作答
• file_upload——檔案提交
• webform——以 Webform 表單作為 activity
• xapi_tincan——xAPI／Tin Can activity
• no_answer——純資訊區塊
• *_feedback 系列——select_single_feedback、select_multiple_feedback、true_false_feedback、free_text_feedback，逐份作答即時回饋

*_feedback 系列比看上去重要。逐份作答即時回饋，會把一個 activity 從評分事件變成學習事件——這對微學習和課程內的形成性評核都很關鍵。

事件、訊息與通知

LMS Messages 與 Drupal 的 Message 模組整合，在 LMS 事件時發送通知。公開的訊息類型清楚地顯示了生態所預期的工作流程：

• lms_messages_new_request——收到加入申請
• lms_messages_approved_request——申請獲批
• lms_messages_rejected_request——申請被拒
• lms_messages_answer_comment——學員作答被留言
• lms_messages_course_evaluation／lms_messages_course_evaluated——已提交評價／學員已評價

對一個企業審批流程——例如員工申請外部培訓、主管審批——頭三個訊息類型就構成完整循環。沒有通知的審批流程，就是一個卡在收件匣裏的流程。

群組：課程、班別與群體

Drupal LMS 使用 Drupal 的 group 模組，設有兩種群組類型：課程群組用 lms_course，課程內的班別小組用 lms_class。這正是學校班級結構與企業以群體為單位的課程交付背後的機制——中十班、管理發展 cohort、全部門合規群組。

DDEV 開發環境

至於本機開發與新項目模板，生態建議採用以 DDEV 為基礎的入門環境。DDEV 提供容器化、可重現的環境，本機毋須安裝 PHP 或數據庫。

git clone [email protected]:graber-1/drupal_lms_ddev.git
cd drupal_lms_ddev
ddev start
ddev composer install
ddev composer update drupal/lms
ddev composer si      # 標準安裝
ddev composer sid     # 安裝＋示範內容＋開發者主控台

兩個安裝腳本值得留意。si 執行一個使用現有設定的精簡安裝；sid 額外執行一個名為 lms-ctt（"create test training"，使用簡單密碼）的 Drush 指令，並安裝開發者主控台——產出一個已填入測試內容的網站，正好適合向客戶示範或讓新開發者上手。

參考設定寫得很明確：php_version: "8.4"、database: mariadb 11.4、webserver_type: nginx-fpm、nodejs_version: "16"，並配備 Selenium standalone Chrome 容器作瀏覽器測試，以及為每個分支設定預覽環境的 Tugboat。

Drupal 11 OOP hooks 與品質工具

Drupal 11 把 hooks 從程序式檔案搬到帶屬性的 OOP hooks。自訂模組宣告一個 hook 的樣子如下：

 [
      'variables' => ['data' => NULL],
    ],
  ];
}

品質工具鏈是配套的一部分，不是可選項：

• PHPUnit（9、10.5 或 11）——單元、kernel 與功能測試
• PHPStan，附棄用規則與嚴格規則，並為既有問題設有基準線
• PHPCS / PHPCBF，採用 Drupal 編碼標準
• config_inspector，用於設定變更偵測

而因為 Drupal LMS 本身就是一個分叉，向上游貢獻是正常工作流程：把模組複製到 web/modules/contrib/lms、把你的分叉加為 remote、在 issue 分支上開發，然後開 merge request。模組樹本身已附帶 phpcs.xml、phpstan.neon 與 phpunit.xml。

這對香港買家意味着甚麼

你買的不是一个黑盒。你買的是建在一個主流 CMS 上的 GPL 代碼，有公開文檔的實體模型、已發布的社群模組、具名的維護者，以及一套標準工具鏈。對香港機構而言具體來說：

• 無按人授權——一間 1,200 名學生的學校或8,000 名員工的企業，不會多出一項按人計算的授權開支。
• 公開的模組清單——你可以清楚看到甚麼存在、甚麼不存在，而不必相信一份供應商功能對照表。
• 內容可攜——SCORM、xAPI、H5P 與 YAML 封裝都能帶走。
• 完整數據庫存取與標準匯出，因為那是你的數據庫。
• 招聘人選充足——Drupal 與 PHP 技能並非小眾，與某些專有LMS 技能組合不同。