nrel/communications-project

这是基于通讯闪电子配置文件分布的Drupal 8站点的项目模板。

1.0.9 2017-09-20 20:49 UTC

This package is auto-updated.

Last update: 2024-09-19 03:32:45 UTC


README

这是一个基于Composer的通讯子配置文件安装程序,基于闪电Drupal分布。欢迎来到未来!

开始使用

$ composer create-project NREL/communications-project MY_PROJECT

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

维护

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

以下表格将是您的指南

神奇之处在于,与Drush不同,Composer是一个依赖管理器。如果模块foo version: 1.0.0依赖于baz version: 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中所有正确版本的依赖项。