使用 Composer 管理 Drupal 项目可精确控制依赖并确保环境一致,推荐通过 composer create-project drupal/recommended-project 初始化;安装模块用 composer require drupal/MODULE_NAME,Composer 会自动处理依赖;更新模块运行 composer update drupal/MODULE_NAME 或整体更新 composer update,并执行 drush updb 升级数据库;核心更新应使用 composer update drupal/core-recommended drupal/core-dev-recommended --with-dependencies 以保持依赖稳定;可通过配置 repository 添加私有源,自定义模块放 web/modules/custom 但不推荐;移除模块需先 drush pmu 再 composer remove;仅提交 composer.json 和 composer.lock 到版本控制,实现可复现部署。

使用 Composer 管理 Drupal 8/9 的核心和模块是现代 Drupal 开发的标准做法。它能帮助你精确控制依赖、避免手动下载模块,并确保环境一致性。
初始化项目并安装 Drupal 核心
如果你从零开始搭建 Drupal 项目,推荐使用官方的项目模板:
composer create-project drupal/recommended-project my_drupal_site这会创建一个名为 my_drupal_site 的目录,包含 Drupal 推荐的文件结构,其中核心代码位于 web 目录下,符合安全最佳实践。
添加和更新模块
使用 composer require 命令安装 contrib 模块(来自 drupal.org):
- composer require drupal/views_bootstrap
- composer require drupal/pathauto
Composer 会自动解析依赖,比如 pathauto 需要 token 模块,它也会一并安装。
升级模块时运行:
- composer update drupal/pathauto
- 或整体更新:composer update
建议在更新后运行数据库更新:drush updb
管理 Drupal 核心更新
Drupal 8/9 使用 drupal/core-recommended 包,它锁定核心组件的版本以保证安全性和稳定性。
睿拓智能网站系统-睿拓企业网站系统1.2免费版软件大小:6M运行环境:asp+access本版本是永州睿拓信息企业网站管理系统包括了企业网站常用的各种功能,带完整的后台管理系统,本程序无任何功能限制下载即可使用,具体功能如下。1.网站首页2.会员注册3.新闻文章模块4.产品图片展示模块5.人才招聘模块6.在线留言模块7.问卷调查模块8.联系我们模块9.在线QQ客服系统10.网站流量统计系统11.后
要更新核心:
- 查看可用更新:composer outdated "drupal/*"
- 执行更新:composer update drupal/core-recommended drupal/core-dev-recommended --with-dependencies
注意:不要单独更新 drupal/core,应使用 recommended 包来保持依赖一致。
处理自定义和特殊需求
某些模块可能不在 Packagist 上,可配置 repository:
composer config repositories.drupal composer https://packages.drupal.org/8若需添加非 Composer 管理的模块(如私有模块),可放入 web/modules/custom 目录,但不推荐长期使用。
移除模块时,先禁用并卸载(drush pmu MODULE_NAME),再执行:
- composer remove drupal/MODULE_NAME
基本上就这些。坚持用 Composer 管理所有外部代码,配合 Git 忽略 vendor 和核心文件,只提交 composer.json 和 composer.lock,就能实现可复现的部署流程。









