README

此项目模板应该可以提供使用Composer管理网站依赖的启动器。

如果您想了解如何将其用作Drush Make的替代品，请访问drupal.org上的文档。

用法

注意：下面的说明参考了全局composer安装。您可能需要根据您的设置将composer替换为php composer.phar（或类似）。

之后您可以创建项目

composer create-project taoti/drupal-project:8.x-dev some-dir --stability dev --no-interaction

使用composer require ...您可以将新的依赖项下载到您的安装中。

cd some-dir
composer require drupal/devel:8.*

模板做什么？

在安装给定的composer.json时，一些任务将被处理

Drupal将被安装在web目录。
实现了自动加载器，以使用vendor/autoload.php中生成的composer自动加载器，而不是Drupal提供的自动加载器（web/vendor/autoload.php）。
模块（类型为drupal-module的包）将被放置在web/modules/contrib/
主题（类型为drupal-theme的包）将被放置在web/themes/contrib/
配置文件（类型为drupal-profile的包）将被放置在web/profiles/contrib/
创建默认的可写版本的settings.php和services.yml。
创建sites/default/files目录。
安装最新版本的drush以在vendor/bin/drush中使用。
安装最新版本的DrupalConsole以在vendor/bin/drupal中使用。

更新Drupal核心

更新Drupal核心是一个两步过程。

更新composer.json中drupal/core的版本号。
运行composer update drupal/core。
运行./scripts/drupal/update-scaffold [drush-version-spec]以更新web目录中的文件，其中drush-version-spec是Drush接受的标识符，例如drupal-8.0.x或drupal-8.1.x，对应于您在composer.json中指定的版本。（默认为drupal-8，最新稳定版。）审查文件以检查任何更改，并将任何自定义设置恢复到.htaccess或robots.txt。
将所有内容一起提交为一个提交，以便在检出分支或运行git bisect时，web将与core保持同步。

从现有项目生成composer.json

使用"Composer Generate" drush扩展，您现在可以从现有项目生成基本的composer.json文件。请注意，生成的composer.json可能与此项目的文件不同。

常见问题解答

我应该提交我下载的contrib模块吗

Composer建议不要。他们提供了反对的论点，但也提供了如果项目决定这样做的话的解决方案。

我如何对下载的模块应用补丁？

如果您需要应用补丁（根据正在修改的项目，通常提出一个拉取请求是一个更好的解决方案），您可以使用 composer-patches 插件。

要将补丁添加到foobar Drupal模块，请在composer.json的extra部分插入patches部分

"extra": {
    "patches": {
        "drupal/foobar": {
            "Patch description": "URL to patch"
        }
    }
}

部署步骤是什么？

部署有一些额外的步骤来获取正确的库和依赖更新。您可以通过使用 Githooks 或您喜欢的部署工具来自动化此过程。基本部署步骤的示例可以在scripts/deploy/deploy.sh中找到。基本步骤如下，路径可能因环境而异

cd /path/to/webroot/
使用ls检查是否存在./.vendor目录。这意味着您在正确的文件夹中。
composer install 这里是您安装/更新库的地方。
cd ./web/ 现在我们进入webroot，运行我们的rush命令。Drush可能已安装在设备上，但建议使用的是包含在.vendor中的安全版本的drush，因此我们这样运行drush

../vendor/bin/drush updb -y # run update.php
../vendor/bin/drush cr all # cache rebuild
../vendor/bin/drush cim git -y # configuration import
../vendor/bin/drush cr all # last cache rebuild

taoti / drupal-project

维护者

详细信息