hughestech/lightning-project

Drupal 8 网站的项目模板,使用 Lightning 发行版构建。

dev-master 2017-08-29 12:21 UTC

This package is not auto-updated.

Last update: 2020-01-03 02:23:28 UTC


README

这是一个基于 Composer 的 Drupal 发行版 Lightning 的安装器。欢迎来到未来!

开始使用

$ composer create-project hughestech/lightning-project MY_PROJECT

Composer 将创建一个名为 MY_PROJECT 的新目录,其中包含一个带有完整 Lightning 代码库的 docroot 目录。然后您可以像安装任何其他 Drupal 网站一样安装它。

维护

drush makedrush pm-downloaddrush pm-update 以及类似的方法是维护代码库的旧方法。忘了它们吧。你现在在 Composer 的世界里!

以下表格可以作为您的指南

任务 Drush Composer
安装贡献项目(最新版本) drush pm-download 项目 composer require drupal/项目
安装贡献项目(特定版本) drush pm-download 项目-8.x-1.0-beta3 composer require drupal/项目:1.0.0-beta3
更新所有贡献项目和 Drupal 核心 drush pm-update composer update
更新单个贡献项目 drush pm-update 项目 composer update drupal/项目
更新 Drupal 核心 drush pm-update drupal composer update drupal/core

与 Drush 不同,Composer 是一个 依赖管理器。如果模块 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 Planet 来,这可能会让您有些不安,但在像这样一个基于 Composer 的项目中,您不应该将安装的依赖项提交到源代码控制

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