hughestech / lightning-project
Drupal 8 网站的项目模板,使用 Lightning 发行版构建。
Requires
- cweagans/composer-patches: ^1.6.0
- drupal-composer/drupal-scaffold: ^2.0.0
- hughestech/lightning: dev-develop
Requires (Dev)
- behat/behat: ^3.0
- behat/mink: ~1.7
- behat/mink-goutte-driver: ~1.2
- composer/composer: ^1.3
- drupal/coder: 8.*
- drupal/console: ^1.0
- drupal/drupal-extension: ~3.2.0
- drush/drush: 8.1.11
- jcalderonzumba/gastonjs: ~1.0.2
- mikey179/vfsstream: ~1.2
- phpunit/phpunit: ~4.8
- se/selenium-server-standalone: ^2.53
- symfony/css-selector: ~2.8
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 make、drush pm-download、drush 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 中正确的所有版本。