测试

介绍

Lumen 在建立时就有考虑到单元测试。事实上，它支持立即使用被引入的 PHPUnit 做测试，而且已经为你的应用程序建立了 phpunit.xml 文件。

在 tests 文件夹有提供一个测试例子。在安装新 Lumen 应用程序之后，只要在命令行上执行 phpunit 来进行测试流程。

定义并执行测试

要建立一个测试案例，只要在 tests 文件夹建立新的测试文件。测试类必须继承自 TestCase，接着你可以如你平常使用 PHPUnit 一般去定义测试方法。

测试类例子

  1. class FooTest extends TestCase {
  3.     public function testSomethingIsTrue()
  4.     {
  5.         $this->assertTrue(true);
  6.     }
  8. }

你可以从终端机执行 phpunit 命令来执行应用程序的所有测试。

注意: 如果你定义自己的 setUp 方法， 请记得调用 parent::setUp。

测试环境

当执行单元测试的时候，Lumen 会自动将环境配置成 testing。另外 Laravel 会在测试环境导入 session 和 cache 的配置文件。当在测试环境里这两个驱动会被配置为 array (空数组)，代表在测试的时候没有 session 或 cache 数据将会被保留。视情况你可以任意的建立你需要的测试环境配置。

testing 环境的变量可以在 phpunit.xml 文件中配置。

从测试调用路由

从单一测试中调用路由

你可以使用 call 方法，轻易地调用你的任何一个路由来测试：

  1. $response = $this->call('GET', 'user/profile');
  3. $response = $this->call($method, $uri, $parameters, $cookies, $files, $server, $content);

接着你可以检查 Illuminate\Http\Response 对象：

  1. $this->assertEquals('Hello World', $response->getContent());

从测试调用控制器

你也可以从测试调用控制器：

  1. $response = $this->action('GET', 'HomeController@index');
  3. $response = $this->action('GET', 'UserController@profile', ['user' => 1]);

注意: 当使用 action 方法的时候，你不需要指定完整的控制器命名空间。只需要指定 App\Http\Controllers 命名空间后面的类名称部分。

getContent 方法会返回求值后的字串内容响应。如果你的路由返回一个 View，你可以通过 original 属性访问它：

  1. $view = $response->original;
  3. $this->assertEquals('John', $view['name']);

你可以使用 callSecure 方法去调用 HTTPS 路由：

  1. $response = $this->callSecure('GET', 'foo/bar');

模拟 Facades

当测试的时候，你或许常会想要模拟调用静态 facade。举个例子，思考下面的控制器行为：

  1. public function getIndex()
  2. {
  3.     Event::fire('foo', ['name' => 'Dayle']);
  5.     return 'All done!';
  6. }

我们可以在 facade 上使用 shouldReceive 方法，来模拟调用 Event 类，它将会返回一个 Mockery mock 对象实例。

模拟 Facade

  1. public function testGetIndex()
  2. {
  3.     Event::shouldReceive('fire')->once()->with('foo', ['name' => 'Dayle']);
  5.     $this->call('GET', '/');
  6. }

注意: 你不应该模拟 Request facade。取而代之，当执行你的测试，传递想要的输入数据进去 call 方法。

框架 Assertions

Lumen 和 Laravel 一样， 附带几个 assert 方法，让测试更简单一点：

Assert 响应为 OK

  1. public function testMethod()
  2. {
  3.     $this->call('GET', '/');
  5.     $this->assertResponseOk();
  6. }

Assert 响应的状态码

  1. $this->assertResponseStatus(403);

Assert 响应为重定向

  1. $this->assertRedirectedTo('foo');
  3. $this->assertRedirectedToRoute('route.name');
  5. $this->assertRedirectedToAction('Controller@method');

Assert 响应的视图包含一些数据

  1. public function testMethod()
  2. {
  3.     $this->call('GET', '/');
  5.     $this->assertViewHas('name');
  6.     $this->assertViewHas('age', $value);
  7. }

Assert Session 包含一些数据

  1. public function testMethod()
  2. {
  3.     $this->call('GET', '/');
  5.     $this->assertSessionHas('name');
  6.     $this->assertSessionHas('age', $value);
  7. }

Assert Session 有错误信息

  1. public function testMethod()
  2. {
  3.     $this->call('GET', '/');
  5.     $this->assertSessionHasErrors();
  7.     // Asserting the session has errors for a given key...
  8.     $this->assertSessionHasErrors('name');
  10.     // Asserting the session has errors for several keys...
  11.      $this->assertSessionHasErrors(['name', 'age']);
  12. }

Assert 旧输入内容有一些数据

  1. public function testMethod()
  2. {
  3.     $this->call('GET', '/');
  5.     $this->assertHasOldInput();
  6. }

辅助方法

TestCase 类包含几个辅助方法让应用程序的测试更为简单。

从测试里配置和刷新 Sessions

  1. $this->session(['foo' => 'bar']);
  3. $this->flushSession();

配置目前为通过身份验证的用户

你可以使用 be 方法配置目前为通过身份验证的用户：

  1. $user = new User(['name' => 'John']);
  3. $this->be($user);

你可以从测试中使用 seed 方法重新填充你的数据库：

在测试中重新填充数据库

  1. $this->seed();
  3. $this->seed('DatabaseSeeder');

更多建立填充数据的信息可以在文档的 迁移与数据填充 部分找到。

重置应用程序

你可能已经知道，你可以通过 $this->app 在任何测试方法中访问你的(应用程序服务容器)。这个服务容器会在每个测试类被重置。如果你希望在给定的方法手动强制重置应用程序，你可以从你的测试方法使用 refreshApplication 方法。这将会重置任何额外的绑定，例如那些从测试案例执行开始被放到 IoC 容器的 mocks。