README

此项目模板提供了一套启动工具，用于使用 Composer 管理您的 LocalGov Drupal 微站点依赖关系。

用法

首先您需要 安装 Composer。

之后您就可以创建项目

composer create-project --stability stable localgovdrupal/localgov_microsites_project:^4.0 MY_PROJECT  --no-install

使用 Lando

如果使用 Lando，您可以启动 Lando 并运行站点安装

cd MY_PROJECT
lando start
lando composer install
lando drush si localgov_microsites -y

使用 DDEV

如果使用 ddev，您可以启动 ddev 并运行站点安装

cd MY_PROJECT
ddev start
ddev composer install
ddev drush si localgov_microsites -y

使用主机机器

如果您直接在主机机器上工作，您仍然需要运行 composer install。

cd MY_PROJECT
composer install
drush si localgov_microsites -y

在 Lando 中运行 PHPUnit 测试

包含的 phpunit.xml.dist 文件包含自动运行 LocalGov Drupal 测试套件的配置。

默认的 .lando.dist.xml 包含用于以下环境变量的配置：

BROWSERTEST_OUTPUT_DIRECTORY: '/app/web/sites/simpletest/browser_output'
BROWSERTEST_OUTPUT_BASE_URL: 'https://localgov-micro.lndo.site'

为了允许 HTML 输出，手动创建一个浏览器输出目录。

mkdir web/sites/simpletest/browser_output

要从 Lando 运行所有 LocalGov Drupal 测试

lando ssh
phpunit

要运行特定模块的所有测试

lando ssh
phpunit web/modules/contrib/localgov_my_module

可以使用 --filter 选项来过滤测试。要仅运行特定的测试

lando ssh
phpunit --filter=myTestName

在 DDEV 中运行 PHPUnit 测试

包含的 phpunit.xml.dist 文件包含自动运行 LocalGov Drupal 测试套件的配置。

默认的 .ddev/config.yml 包含 ddev 和 phpunit 需要解析不同微站点域名的一些额外域名配置。

当 ddev 启动时，它会尝试将这些写入 /etc/hosts

如果 DDEV 无法写入 /etc/hosts，您可能需要手动添加这些。

如果您在 DDEV 中运行 phpunit 测试时遇到问题，请尝试将以下内容添加到 /etc/hosts

127.0.0.1 group-1.web group-2.web group-3.web group-4.web group-5.web

为了允许 HTML 输出，手动创建一个浏览器输出目录。

mkdir web/sites/simpletest/browser_output

要从 DDEV 内运行所有 LocalGov Drupal 测试

ddev ssh
phpunit

要运行特定模块的所有测试

ddev ssh
phpunit web/modules/contrib/localgov_my_module

可以使用 --filter 选项来过滤测试。要仅运行特定的测试

ddev ssh
phpunit --filter=myTestName

维护者

此项目目前由以下人员维护：

• Ekes: https://www.drupal.org/u/ekes
• Finn Lewis: https://www.drupal.org/u/finn-lewis
• Stephen Cox: https://www.drupal.org/u/stephen-cox