README

此项目模板应提供使用 Composer 管理网站依赖的启动服务。

如果您想了解如何将其用作 Drush Make 的替代方案，请访问 drupal.org 上的文档。

使用方法

注意：以下说明针对的是全局Composer安装。您可能需要根据您的设置将 composer 替换为 php composer.phar（或类似）。

之后您就可以创建项目了

composer create-project burdamagazinorg/thunder-infrastructure my-project-dir --stability dev --no-interaction

使用 composer require ... 您可以将新依赖项下载到您的安装中。

cd my-project-dir
composer require drupal/devel:1.*

composer create-project 命令将所有文件的所有权传递给创建的项目。您应该创建一个新的git仓库，并提交所有由 .gitignore 文件排除的文件。

模板做什么？

在安装给定的 composer.json 时，一些任务将得到处理

Drupal 将安装在 docroot 目录中。
实现了自动加载器，以使用位于 vendor/autoload.php 的生成的Composer自动加载器，而不是Drupal提供的自动加载器（docroot/vendor/autoload.php）。
模块（类型为 drupal-module 的软件包）将放置在 docroot/modules/contrib/
主题（类型为 drupal-theme 的软件包）将放置在 docroot/themes/contrib/
配置文件（类型为 drupal-profile 的软件包）将放置在 docroot/profiles/contrib/
下载Drupal脚手架文件，如 index.php 或 .htaccess
创建 sites/default/files 目录。
安装最新的drush版本，以便在 bin/drush 中使用。
安装最新的DrupalConsole版本，以便在 bin/drupal 中使用。
安装最新的behat版本，以便在 bin/behat 中使用。
安装最新的robo版本，以便在 bin/robo 中使用。

安装Thunder

此项目包含一些robo（一个PHP任务运行器）脚本，可以安装和更新网站。

要安装网站，运行 ./bin/robo site:install [环境]。

[环境] 对于已知数据库设置的安装，为 local，
如果使用 Acquia DevDesktop，则为 devdesktop。
- 在这种情况下，您应该在执行命令之前在 DevDesktop App 中 导入本地Drupal网站。

如果 ./database 中不存在数据库转储，则脚本将安装网站，启用扩展 config 和 locale，更新区域设置，导出配置并创建数据库转储。

如果存在数据库转储，它将仅导入它。

更新Thunder

项目更新

要更新网站，运行 ./bin/robo site:update [环境]。（查看 安装Thunder 了解需要哪个 [环境]）
这将导入配置，应用数据库和模式更新，并更新区域设置。

文件更新

此项目将尝试保持所有Thunder和Drupal核心文件是最新的；项目 drupal-composer/drupal-scaffold 用于确保每次更新 drupal/core 时，您的脚手架文件都会更新。如果您自定义了任何“脚手架”文件（通常是 .htaccess），那么当您的修改文件在Drupal核心的新版本中更新时，您可能需要解决合并冲突。

按照以下步骤更新您的Thunder文件。

运行 composer update burdamagazinorg/thunder
运行 git diff 以确定是否有任何脚手架文件已更改。检查文件以查看任何更改，并将对 .htaccess 或 robots.txt 的任何自定义修改恢复。
将所有内容一起提交为一个单独的提交，这样在检出分支或运行 git bisect 时，web 将与 core 保持同步。
如果在第2步中有非平凡冲突，您可能需要在分支上执行这些步骤，并使用 git merge 将更新的核心文件与您的自定义文件合并。这可以使用 kdiff3之类的三向合并工具来方便地完成。如果您的更改很简单，则不需要这种设置；将所有修改保持在文件的开始或末尾是一个很好的策略，以保持合并简单。

常见问题解答

我应该提交我下载的贡献模块吗

Composer建议不要这样做。他们提供了反对的论据，但同时也提供了绕过方法的解决方案。

如何应用补丁到下载的模块？

如果您需要应用补丁（根据修改的项目，Pull Request通常是一个更好的解决方案），您可以使用 composer-patches 插件。

要将补丁添加到drupal模块foobar，在composer.json的extra部分中插入patches部分

"extra": {
    "patches": {
        "drupal/foobar": {
            "Patch description": "URL to patch"
        }
    }
}

如何防止下载Thunder中不需要的模块？

要防止下载Thunder提供的但不需要的模块，请向您的composer.json中添加一个replace块

"replace": {
    "drupal/features": "*"
}

此示例防止下载任何版本的feature模块。

burdamagazinorg / thunder-infrastructure

维护者

详细信息