Drupal 安装模块

文中部分内容为 drush 命令,不熟悉 drush 的用户可忽略,不影响学习本文内容

什么是模块?

参考《Drupal 基础概念》中的模块条目。

模块安装步骤

  1. 发现模块
  2. 下载/上传模块(如有依赖其它模块,也需要一同下载)
  3. 安装与卸载模块
  4. 配置及使用模块

发现模块

官网的模块列表页面(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 地址或上传方式将模块放置到模块目录下。

Drupal 安装模块界面

注意:需要 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] )的介绍和文档(如有)。本站模块列表中的模块也会包含相关的中文使用说明。

更多参考