文中部分内容为 drush 命令,不熟悉 drush 的用户可忽略,不影响学习本文内容
什么是模块?
参考《Drupal 基础概念》中的模块条目。
模块安装步骤
- 发现模块
- 下载/上传模块(如有依赖其它模块,也需要一同下载)
- 安装与卸载模块
- 配置及使用模块
发现模块
官网的模块列表页面(https://www.drupal.org/project/project_module)有数以万计的各种不同功能的模块,用户可根据关键词搜索和版本过滤等功能,寻找所需要的模块。
除官方模块列表外,本站也提供了中文版的模块列表,包含了模块的中文介绍、用法和其它实用信息。
下载/上传模块
在模块的项目页面(https://www.drupal.org/project/ [module_name]
),可以选择对应版本的模块包进行下载,并解压到模块目录。
- Drupal 7 及以前:常用的模块目录为
sites/all/modules
- Drupal 8 及以后:常用的模块目录为网站根目录下的
modules
和sites/all/modules
为方便区分,官方提倡新建 contrib 子目录放置从官网下载的第三方模块,新建 custom 目录放置自己开发的模块。
示例目录结构
/module
|- contrib
|- admin_toolbar
|- backup_migrate
|- ...
|- custom
|- my_custom_module_a
|- my_custom_module_b
|- ...
使用后台管理界面下载/上传
访问后台安装模块页面(admin/modules/install),可以通过 URL 地址或上传方式将模块放置到模块目录下。

注意:需要 FTP 写入权限
使用下载工具下载模块
可使用任意下载工具,从模块项目页面进行下载,然后解压、上传到模块目录。
使用 drush 下载模块
使用 drush dl [module_name]
进行下载,Drupal 7 及以前版本推荐,Drupal 8 及以后版本推荐使用 Composer 进行下载。
使用 composer 下载模块
Drupal 8 开始官方推荐的模块下载方式,执行命令 composer require drupal/[module_name]
进行下载。
国内用户可使用阿里云提供的 Composer 镜像提升下载速度:https://developer.aliyun.com/composer
使用 ludwig 模块下载模块
适用于无法使用 Composer 的情况,暂略。
安装与卸载模块
使用模块管理页面
通过模块管理界面(admin/modules),可以对模块进行 安装(启用)/禁用/卸载 等操作。
- Drupal 7 及之前:模块有 安装(启用)/禁用/卸载 等几种操作,禁用模块可以暂时停止模块的功能,同时保存模块配置和数据不变,便于在需要时可以再随时启用。
- Drupal 8 及之后:模块只有 安装 /卸载 两种操作,用以避免模块在禁用状态下的一些问题。如需要保存模块配置和数据,可以通过“导出-导入”配置的方式达到还原需要。
- Drupal 8 及之后版本:
- 安装模块:在模块列表(admin/modules)页面,勾选模块,点击安装
- 卸载模块:在模块卸载(admin/modules/uninstall)页面,勾选模块,点击卸载
- Drupal 7 及之前版本:
- 安装/启用模块:在模块列表页面,勾选模块,点击保存配置
- 禁用模块:在模块列表页面,勾选模块,点击保存配置
- 卸载模块:在模块卸载页面,勾选模块,点击卸载
注意:如某些模块不能勾选可能是因为其依赖模块未能被找到,将依赖模块下载到模块目录下,再刷新页面进行勾选、安装。
卸载模块时,被依赖的模块需要在所有依赖它的模块被卸载后,才能进行卸载。
使用 drush 命令行
相比使用后台管理界面,drush 命令行提供了更高效的管理方法。drush 不仅可以快速执行操作,当在处理有依赖性的模块时,还可以自动提示 下载/安装/卸载 依赖模块。
drush en [module_name] # drush pm-enable 的缩写,用于安装/启用模块
drush dis [module_name] # drush pm-disable 的缩写,用于禁用模块
drush pmu [module_name] # drush pm-uninstall 的缩写,用于卸载模块
配置及使用模块
模块安装后,可能还需要设置用户权限和进行配置。每个模块的配置和用法各不相同,具体请参考模块项目页面(https://www.drupal.org/project/ [module_name]
)的介绍和文档(如有)。本站模块列表中的模块也会包含相关的中文使用说明。
更多参考: