README

这是一个基于Composer的安装器，用于Demo Framework Drupal发行版。

开始使用

$ composer create-project acquia/df-project MY_PROJECT -s dev

Composer将创建一个名为MY_PROJECT的新目录，其中包含一个包含完整Demo Framrwork代码库的docroot目录。然后您可以像安装其他Drupal站点一样安装它。

如果您需要帮助设置环境，我们建议使用DDev或Acquia Developer Studio。您也可以使用drush的runserver命令和一个本地sqlite数据库快速启动一个站点。

drush runserver

drush site-install --db-url=sqlite://../df.sqlite

DF的其他测试环境包括Acquia Dev Desktop、Acquia Cloud和Acquia Cloud Site Factory。

维护

一旦您基于此项目启动了新项目，您可能想要添加更多扩展。以下表格将为您提供指南

任务	Drush	Composer
安装贡献项目（最新版本）	`drush pm-download 项目`	`composer require drupal/项目`
安装贡献项目（特定版本）	`drush pm-download 项目-8.x-1.0-beta3`	`composer require drupal/项目:1.0.0-beta3`
安装JavaScript库（例如dropzone）	`drush pm-download dropzone`	`composer require bower-asset/dropzone`
更新所有贡献项目和Drupal核心	`drush pm-update`	`composer update`
更新单个贡献项目	`drush pm-update 项目`	`composer update drupal/项目`
更新Drupal核心	`drush pm-update drupal`	`composer update drupal/core`

神奇之处在于，Composer与Drush不同，它是一个依赖管理器。如果模块foo版本：1.0.0依赖于baz版本：3.2.0，Composer将不允许您将baz更新到3.3.0（或将其降级到3.1.0）。Drush没有依赖管理的概念。如果您曾因类似的问题意外破坏了网站，您可能已经意识到Composer的价值。

但为了明确：使用像Drush或Drupal Console这样的站点管理工具仍然非常有帮助。例如，数据库更新（drush updatedb）等任务仍然属于此类实用工具的范畴。此安装器将在bin目录中安装Drush的副本（针对项目本地）。

指定版本

您可以使用命令行指定版本

$ composer require drupal/<modulename>:<version>

例如

$ composer require drupal/ctools:3.0.0-alpha26
$ composer require drupal/token:1.x-dev

在这些示例中，composer版本3.0.0-alpha26映射到drupal.org版本8.x-3.0-alpha26，1.x-dev映射到drupal.org的8.x-1.x分支。

如果您指定了一个分支，例如1.x，必须在版本末尾添加-dev。

Composer只负责维护代码库.

源代码控制

如果您查看我们提供的 .gitignore 文件，您会看到某些目录，包括所有包含贡献项目的目录，都被排除在版本控制之外。如果您刚从Drush星球来，这可能会让您有些不安，但在像这样一个基于Composer的项目中，您不应该将已安装的依赖项提交到版本控制。

当您设置项目时，Composer将创建一个名为 composer.lock 的文件，其中列出了安装了哪些依赖项及其版本。将 composer.lock 提交到版本控制！然后，当您的同事想要启动他们自己的项目副本时，他们只需要运行 composer install，这将安装 composer.lock 中所有正确版本的依赖项。

acquia / df-project

维护者

详细信息

README

开始使用

维护

指定版本

源代码控制