安装 Drupal 8 模块
安装一个或多个模块,以便通过附加功能修改、扩展或改进 Drupal。
必要的知识
步骤 1:获取模块
如果要安装的模块是 Drupal 核心的一部分,你可以直接跳到下一步。
要安装模块,首先需要获取模块的源代码。推荐的方式是使用 Composer 将模块作为依赖添加到你的项目中。这假设你已经在使用 Composer 管理你的项目。
要添加一个 模块,请先确定它的机器名称。这是项目页面 URL 的最后一部分。例如,模块 Geofield 的地址为 https://www.drupal.org/project/geofield,其机器名称为 geofield。
要下载该模块及其依赖项,请在网站根目录中运行以下命令(将 geofield 替换为你的模块名称):
composer require drupal/geofield
执行命令后,你将看到一条消息,表示模块已作为依赖项添加到 composer.json 文件中,并且相关代码已下载。
更多信息和视频演示请参阅:使用 Composer 下载和更新文件 与 使用 Composer 下载模块和主题。
其他获取模块的方式包括:
步骤 2:启用模块
使用 Drupal 界面:
- 通过“管理”菜单进入“扩展”页面(/admin/modules)。
- 找到要启用的模块,在每个模块旁勾选复选框。
- 点击“安装”以启用新模块。
使用 Drush:
drush en geofield
更多信息和视频演示请参阅:从 Drupal.org 下载并安装模块 与 通过命令行安装模块。
附加信息
模块存放结构
Drupal 会在多个位置查找模块:推荐使用根目录下的 /modules 目录,或者 /sites/*/modules 目录。Drupal 会遍历这些目录中的所有子文件夹以查找模块。
通常的做法是:将从 Drupal.org 下载的所有模块放在 /modules/contrib 目录中,而将包含自定义代码的项目模块放在 /modules/custom 目录中。
单个项目包含多个模块
通常,一个项目(例如 https://drupal.org/project/devel)包含多个模块。每个模块都会在“扩展”页面上单独列出,并可以单独启用。