README

本项目使用“分割核心”技术来管理您的Drupal 8依赖项。从Drupal 8.0.0-rc1开始，您可以直接使用composer require从您的Drupal根目录添加额外的依赖项。

参见：使用Site-Local Drush避免“依赖地狱”

旧文档

本项目利用pantheon-systems/circle-scripts项目来实现以下功能

• 在composer.json文件中指定您使用的Drupal模块、主题和库，并使用Composer构建它们。
• 通过Circle CI自动构建组件，每次提交时自动构建。
• 使用Behat在Circle上对您的网站进行测试。
• 每次测试通过时，自动将您的网站部署到Pantheon开发环境或某个分支。

本项目基于drupal-composer/drupal-project项目。

创建新项目

在开始之前，您应该首先安装composer。

有两种方法可以快速使用本项目作为模板创建Drupal站点的项目。

通过GitHub

• 在GitHub上Fork此项目
• 在本地克隆您的Fork
• $ cd example-drupal8-circle-composer
• composer install
• $ ./bin/init-new-project

init-new-project脚本将设置您需要的本地文件，并将它们提交到本地git仓库。

通过Composer

$ composer create-project pantheon-systems/example-drupal8-circle-composer my-new-project-name

composer create-project将下载您新项目所需的基文件，然后运行init-new-project脚本进行设置。结果将提交到本地git仓库。您可能希望将您的仓库推送到GitHub。

配置

创建新项目后，您仍需要进行一些定制步骤以满足您的特定需求。有关说明，请参阅circle-scripts README。

文件夹'scripts'包含一些起始脚本，您可以使用它们来定制测试所需的测试环境。

本地测试

$ ./bin/local-test

local-test脚本将设置本地Drupal站点，使用PHP内置的web服务器运行它，然后运行Behat测试套件。这与每次提交在Circle上发生的情况类似。

仓库管理

您可以将自定义模块和主题分别放在drupal/sites/all/modules/custom和drupal/sites/all/themes/custom中，并将它们提交到包含您的composer.json文件的同一仓库。

如果您愿意，您也可以为您的自定义组件创建一个Composer项目，并将它们添加到您的composer.json文件中。为了进行此操作，不需要使您的代码公开可访问；您可以创建一个指向私有GitHub仓库的本地Composer包定义。有关创建Composer包的不同方法的详细信息，请参阅创建您自己的Composer包。

可以使用Composer添加额外的模块。

$ cd my-new-project-name
$ composer require drupal/devel '8.*'

这将把指定的模块放置在sites/all/modules/contrib中，并且还将更新您的composer.json文件，其中包含刚刚添加的模块信息。