README

此存储库是使用Pantheon的Composer-based WordPress工作流程的起始状态。它旨在被Terminus Build Tools 插件复制，该插件将为您设置一个全新的

GitHub仓库
免费Pantheon沙盒网站
A CircleCI配置，用于运行测试并将源代码库（GitHub）推送到Pantheon。

有关此工作流程样式的更多背景信息，请参阅Pantheon文档。

安装

先决条件

在运行terminus build:project:create命令之前，请确保您已满足所有先决条件

Pantheon账户
Terminus，Pantheon命令行工具
Terminus Build Tools 插件
GitHub账户和一个能够创建新仓库的认证令牌。
CircleCI账户和一个认证令牌。

您可能发现将GitHub和CircleCI令牌作为变量导出到命令行中更容易，这样Build Tools 插件可以自动检测它们

export GITHUB_TOKEN=[REDACTED]
export CIRCLE_TOKEN=[REDACTED]

一键设置

一旦您满足了所有先决条件，您就可以使用一个命令创建此仓库的副本

terminus build:project:create pantheon-systems/example-wordpress-composer my-new-site --team="Agency Org Name"

这里显示的参数是

源仓库的名称，pantheon-systems/example-wordpress-composer。如果您对其他源仓库（如Drupal 8）感兴趣，请参阅Terminus Build Tools 插件。
将被用于即将创建的Pantheon网站和GitHub仓库的机器名。将my-new-site更改为对您有意义的名称。
--team标志是可选的，它指的是Pantheon组织。Pantheon组织通常是网络开发机构或大学。设置此参数会导致新创建的网站位于指定的组织内。运行Terminus命令terminus org:list以查看您是哪些组织的成员。可能没有任何组织。

重要文件和目录

`/web`

Pantheon将通过配置在pantheon.yml中的/web子目录提供网站服务，从而促进基于Composer的工作流程。将您的网站放在此子目录中还可以允许将测试、脚本和其他与您的项目相关的文件存储在您的仓库中，而不会污染您的Web文档根目录。

`/web/wp`

即使在/web目录中，您也可能注意到其他目录和文件位于不同的位置，与默认WordPress安装相比。查看/web/wp-config.php中的关键设置，如WP_SITEURL，允许WordPress核心移动到/web/wp。仓库中目录的整体布局受到了Bedrock的启发。

`composer.json`

如果您只是在GitHub上浏览这个仓库，可能看不到上面提到的某些目录，例如wp-admin。这是因为WordPress核心及其插件是通过Composer安装的，并且在.gitignore文件中被忽略。特定的插件是通过composer.json添加到项目的，而composer.lock文件则记录了每个插件（或其他依赖项）的确切版本。通用的Composer依赖项（非WordPress插件或主题）被下载到/vendor文件夹。

Behat测试

为了让CircleCI有一些测试可以运行，这个仓库包含了一个WordHat的配置，它是WordPress Behat扩展。您可以在/tests/behat/features目录下添加自己的.feature文件。有关使用Behat进行WordPress测试的更全面指南即将推出。

stevector / example-wordpress-composer

维护者

详细信息