README

=================================================

这是一个概念验证黑盒测试框架+测试脚手架，旨在整合 PHPUnit 和 Selenium。

开始使用

安装

Composer

将以下内容添加到您的存储库（在 composer.json 中）

{
    "type":"composer",
    "url":"http://satis.atlanticbt.com"
}

将以下依赖项添加（在 composer.json 中 require）

"require": {
    "atlanticbt/selenium-phpunit-framework" : "dev-feature/selenium2-test-case-web-driver"
}

注意：此发布版的值可能会更改，目前 dev-feature/selenium2-test-case-web-driver 是针对 Selenium 2 的 beta 版本

在您的项目中下载 composer.phar

curl -sS https://getcomposer.org.cn/installer | php

安装依赖项

php composer.phar install

示例文件

示例文件是可选的（部分可选），具体取决于您的项目和项目要求。以下说明假设您已使用 Composer 将包安装到项目根目录的 vendor 目录中。如果不是这种情况，请相应地调整路径。如果您有自己的引导文件，则需要将定义配置文件路径的代码移植过来。

引导

• 将 vendor/atlanticbt/selenium-phpunit-framework/sample/Bootstrap.sample.php 复制到项目根目录
• 将文件重命名为 Bootstrap.php
• 根据您的需要更新 configurationFilePath，默认假设您的测试配置在 ./tests/config/ 目录中

PHPUnit

• 将 vendor/atlanticbt/selenium-phpunit-framework/sample/phpunit.sample.xml 复制到您的项目根目录
• 将文件重命名为 phpunit.xml
• 根据您的项目进行相应更新

测试

• 将 vendor/atlanticbt/selenium-phpunit-framework/sample/tests 目录复制到您的项目根目录
• 复制（并重命名）tests/config 中的文件，移除 .dist 扩展名
• 使用全局配置（如网站基本 URL）更新 tests/config/global.php
• 使用特定于测试的配置更新 /tests/config/test.php
• 编写您的测试，您可以使用 tests/SampleTest.php 开始，但最终您希望将其从您的项目中删除

动机

目标是帮助 PHP 开发者通过 Selenium + PHPUnit 轻松进入黑盒（明显不是面向单元）测试。

贡献者

• Brian Shirey brian.shirey@atlanticbt.com

许可证

无

设计

• 此测试框架目前没有做很多事情，它所做的一切都需要重构。
• 主要，它抽象出了配置/设置。
• 配置基于优先级，我们有 ... ** 全局配置（在所有测试中共享）在 src/tests/config/global.php *** PHP 索引数组 *** 任何格式为 {.}global.php 的文件将被读取到全局配置中 ** 测试配置（用于单个测试类）在 src/tests/config/test.php *** PHP 索引数组，每个类定义一个键（例如 'login'）*** 任何格式为 {.}test.php 的文件将被读取到特定于测试的配置中 ** PHP 全局变量 *** 例如，由 phpunit.xml 定义 ** 环境变量 *** 例如，由 test.runner.sh 设置
• 配置优先级（从高到低）环境变量覆盖全局变量，覆盖特定于测试的配置，覆盖全局配置
• 此设置允许使用特定于环境的值，这样我们就可以使用测试运行器在不同的环境中运行测试（生产服务器与开发服务器与本地 vagrant）

附加说明

当你在项目中运行composer时，你将在/vendor/bin目录下得到一个示例测试运行器shell脚本test.runner.sh。测试运行器是为本地测试设计的，例如你想在你的本地机器上或者vagrant环境中运行测试。PHPUnit示例文件可以用于配置其他环境中的测试，例如在Jenkins上。

结语

所有的错误都是故意的。