1.5.2 WebPagetest中继（WebPagetest Relay）

目前的系统架构有每个测试代理直接连接到WebPagetest服务器，用于检索工作和发布结果：

这适用于很多用例，但它要求所有代理可访问服务器，并且每个代理只能为单个服务器运行测试。添加对中继服务器的支持是有用的，该中继服务器一方面公开相同的代理接口，另一方面为WebPagetest服务器提供API来进行通信。
在简单的用例中，这将允许继电器放置在不安全的位置（例如公共互联网）。但服务器本身可以在防火墙或其他安全区域内运行，在公共互联网上以及防火墙内都有测试代理：

假设WebPagetest服务器上每个定义的“位置”都可以引用不同的中继服务器，并且每个中继服务器可以支持连接到它的多个服务器（使用基于密钥的身份验证），这样可以打开很多有趣的可能性：

• 多个系统可以共享测试代理池（拥有控制对它们的访问的中继器）。 分享可以是直接的协作或更复杂的地方，每个用户对于他们的使用份额进行收费，甚至是直接订阅模式，其中所有者以每个测试的方式销售能力
• 中继服务器可以优先处理服务器请求测试的请求（基于任何对系统有意义的优先级排序）
• 给定的WebPagetest实例可以利用公共和私有测试代理，甚至通过使用多个继电器从多个公共代理池中抽取

实施细节

任何完整的WebPagetest实例可以作为中继器运行，并进行一些调整

• runtest.php - 添加对直接上传的测试作业的支持（并将作业绑定到所使用的API密钥）
• common.inc - getTestPath() - 组合API密钥和测试ID，形成新的测试ID，并将测试结果存储在不同的树中
• downloadtest.php - 添加一个新界面来下载给定测试的zip存档（基本上与发布相同，但在pull模式中）
• deletetest.php - 添加一个新的界面来显式删除测试（基于匹配的API键）

WebPagetest接口

• 可以将locations.ini中的任何位置配置为与中继服务器通信，具有以下设置：
  • Relay server URL (base URL)
  • Relay location ID (中继服务器的位置ID)
  • Relay Key (API与中继服务器连接时使用的密钥)
• 当测试提交到本地服务器时，不是将测试作业写入本地文件，而是将其发布到中继服务器
• 检查测试状态时，如果测试不完整，则WebPagetest会询问中继服务器的状态
• 如果中继服务器指示测试完成，则WebPagetest会将中继服务器的结果作为zip压缩并将其解压缩
  • 下载/提取后，WPT将表明它已经完成了测试，所以中继服务器可以删除它的副本

代理接口

• 代理将与中继进行通信，就像他们正在与WebPagetest进行通信（work/getwork.php，work/resultimage.php，work/workdone.php）

中继服务器实施

• 一个专用的中继服务器将只是一个完整WPT的一部分，不需要UI支持（SVN用于将选定的文件放在dist版本的wptrelay目录中）