从 Drupal 8.8.0 开始,Drupal 使用 drupal/recommended-project 作为 Composer 安装模板。
# 安装最新稳定版本 Drupal
composer create-project drupal/recommended-project my_site_dir
如需安装指定版本的 Drupal,可以使用
drupal/recommended-project:9.0.1
。使用composer show drupal/recommended-project --all
或访问 Packagist 站点查看所有支持的版本。
drupal/recommended-project 将 index.php 和 core 目录等网站文件放置在项目根目录下的 web 目录下,通过将 vendor 目录放置在站点目录外,使站点更安全。
# 目录结构
composer.json
composer.lock
web
vendor
其它常用命令
# 查询所有 Composer 可用的 Drupal 版本
composer show drupal/recommende-project --all
# 安装指定的 Drupal 版本
composer create-project drupal/recommended-project:9.0.1 my_site_dir
# 仅下载不安装,根据需要修改 composer.json 后再使用 composer install 自行安装项目
composer create-project --no-install drupal/recommended my_site_dir
# 安装 Drupal 模块/主题:composer require drupal/[project_name]
composer require drupal/pathauto
# 安装开发用模块,添加 --dev 参数
composer require drupal/devel
# 检查内核及模块更新
composer outdated drupal/*
# 更新 Drupal 模块、主题和内核
composer update
# 仅更新 Drupal 内核(不含模块和主题)
composer update drupal/core-recommended --with-dependencies
# 如希望运行 PHPUnit 测试 Drupal 内核,需添加 core-dev
composer require drupal/core-dev
# 添加 drush(需要在 drupal/core-dev 之后安装或同时安装)
composer require drush/drush