README

运行Codeception测试的Web界面。

使用Slim PHP框架和Foundation CSS框架构建。

它做什么？

Webception是一个可部署的Web应用程序，允许您在浏览器中运行所有Codeception测试。

您可以访问多个测试套件，并决定哪些测试要在运行中包含。它允许您在查看控制台中的测试结果的同时启动、停止和重新启动进程。

它看起来像什么？

很高兴你问了...

理想的用法是什么？

如果您是Web开发者，您可能运行了一个演示服务器，该服务器托管您客户的正在进行中的工作。

Webception的理想设置是在您的演示服务器上的子域（例如webception.your-staging-domain.com），这样它就可以访问所有测试套件。

它将做什么？

Webception仍在开发中。查看路线图以获取短期目标。

如果您想参与其中，请查看如何贡献。

要求

运行PHP 5.3.0+的Web服务器和Composer。Codeception将通过Composer安装。

安装

出厂设置，Webception配置为运行它自己的Codeception测试。

您需要Composer已安装，Codeception可执行文件和日志目录需要完整的读写权限。

要配置Webception以满足您的需求（例如，运行您自己的测试），请将App/Config/codeception-local-sample.php复制到App/Config/codeception-local.php，并覆盖来自App/Config/codeception.php的设置。这里您可以添加对codeception.yml配置的引用。

请注意，Webception的codeception.yml已配置为使用http://webception:80作为其主机。将其更改为您决定运行Webception的任何主机和端口。

1. 部署Webception

您可以使用Composer安装Webception

composer create-project jayhealey/webception --stability=dev

或下载Webception并解压缩。一旦解压缩，您需要使用以下命令安装Composer依赖项

composer install

现在您可以执行以下操作

确保Codeception有权限

sudo chmod a+x vendor/bin/codecept
设置权限，以便Codeception可以写入日志文件

sudo chmod -R 777 App/Tests/_log
设置权限，以便Slim PHP可以写入模板缓存

sudo chmod -R 777 App/Templates/_cache
将您的新服务器指向您解压缩Webception的public路径。

现在您可以在浏览器中加载Webception。

如果出现问题，Webception将尽力告诉您需要做什么。

2. 自定义Webception配置

在/App/Config/codeception.php中，您可以操作几个配置文件。

将您自己的测试添加到Webception

您可以通过向sites数组添加来添加您需要的任何数量的Codeception测试套件

'sites' => array(
   'Webception' => dirname(__FILE__) .'/../../codeception.yml',
),

按您想要的顺序排列它们。如果您只有一个条目，您将看不到下拉列表。

请随意删除/替换 Webception 条目，使用您自己的测试套件。

如果在配置中设置了多个网站，您可以使用 Webception 左上角的网站选择器在测试套件之间切换。

记住：您需要将 sudo chmod -R 777 /path/to/logs 命令设置在 codeception.yml 配置中声明的日志目录。如果不这样做，Webception 将无法运行测试。

注意：使用 $_SERVER['DOCUMENT_ROOT'] 来定义配置路径可能会遇到问题。最好将应用程序根目录的绝对路径或使用 dirname(__FILE__) 的相对路径放入其中。

3. 运行您的测试！

如果您已经正确配置了一切，Webception 将显示所有可用的测试。只需点击开始运行所有测试！

就是这样！祝您测试愉快！

想要贡献？

您可以通过几种方式联系我们。

在 Twitter 上聊天。关注 @WebceptionApp 获取版本更新，或关注 @JayHealey 获取其他信息。
通过 GitHub Issues 发布错误、问题、功能请求。
在 GitHub 上拉取 & 分叉 如果您想动手操作。请确保您添加的任何新功能都与关联的测试相关联，并在可能的情况下将您的功能请求指向适当的版本（如路线图中所述）。

请告诉我 如果您使用 Webception。我渴望了解您如何想要使用它，以及您在未来的版本中希望看到什么。

我对如何改进 Webception 的任何反馈都持开放态度。从 SlimPHP 的提示到如何最好地改进 Codeception 的处理，再到改进 UI。我很乐意倾听！

常见问题解答 (IAQs)

为什么我会使用 Webception？

Webception 的目标是让所有参与网络开发项目的成员都能打开测试套件。这可能是一个团队领导、其他开发者（可能不是 PHP 开发者）、客户经理甚至客户。

计划是将此工具发展成为您流程中有价值的一部分。可能集成 CI 工具或成为错误报告流程的一部分。

而且自私地说，我找不到其他可以作为 Codeception 网络界面的东西，所以这是一个值得解决的问题。

Webception 是由与 Codeception 一样的人制作的吗？

不是的。它是完全非官方的。它不以任何方式与 Codeception 的构建者有关联或赞助。

因此，请将有关 Webception 的所有问题发布在 Webception GitHub Issues 页面上。

路线图

自动/交互式设置：我希望用交互式安装程序替换手动设置，该安装程序会在您输入时验证 Codeception 测试套件的相关细节。您还应该能够通过应用程序而不是修改配置文件来添加/删除测试套件。找到所有可用的 codeception.yml 文件有助于自动化安装。
日志和截图：当 Codeception 运行时，它会创建测试失败的 HTML 快照和截图。对于 Webception 来说，将那些文件复制过来并通过控制台使它们可访问将很有用。
安全：目前，您只需使用 .htaccess 保护安装即可 - 但可能值得通过 Slim 模块添加内置安全功能。
公开单元测试：单元测试包含多个测试在一个文件中，所以扫描单元测试以暴露它们会很好——然后允许运行这些测试中的每一个（这是否在Codeception中可行？）。
更多Webception测试：一个运行测试的应用程序应该充满测试，这感觉是合适的。所以，未来会有更多的测试。

还有一个待办事项列表，其中包含了我想要改进的一些事情。

如果您有任何想法或问题，请在GitHub Issues或Twitter上的@WebceptionApp上留言。

jayhealey / webception

维护者

详细信息