* * * * *
[TOC]
## 基础介绍
Laravel 为 HTTP 请求的生成和发送操作、输出的检查都提供了非常流利的 API。例如，你可以看看下面的这个测试用例：
~~~
<?php
namespace Tests\Feature;
use Tests\TestCase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;
class ExampleTest extends TestCase
{
/**
* A basic test example.
*
* @return void
*/
public function testBasicTest()
{
$response = $this->get('/');
$response->assertStatus(200);
}
}
~~~
`get` 方法会创建一个 `GET` 请求来请求你的应用，而 `assertStatus` 方法断言返回的响应是给定的 HTTP 状态码。除了这个简单的断言之外，Laravel 也包含检查响应标头、内容、 JSON 结构等等的各种断言。
## Session / 认证
Laravel 提供了几个可在测试时使用 Session 的辅助函数。首先，你需要传递一个数组给 `withSession` 方法来设置 Seesion 数据。这让你在应用程序的测试请求发送之前，先给数据加载 Session 变得简单：
~~~
<?php
class ExampleTest extends TestCase
{
public function testApplication()
{
$response = $this->withSession(['foo' => 'bar'])
->get('/');
}
}
~~~
当然，一般使用 Session 时都是用于维持用户的状态，如认证用户。`actingAs` 辅助函数提供了简单的方式来让指定的用户认证为当前的用户。例如，我们可以使用 [模型工厂](https://laravel-china.org/docs/laravel/5.4/database-testing#writing-factories) 来生成并认证用户：
~~~
<?php
use App\User;
class ExampleTest extends TestCase
{
public function testApplication()
{
$user = factory(User::class)->create();
$response = $this->actingAs($user)
->withSession(['foo' => 'bar'])
->get('/')
}
}
~~~
你也可以通过传递 guard 名称作为 `actingAs` 的第二参数以指定用户通过哪种 guard 来认证:
~~~
$this->actingAs($user, 'api')
~~~
## 测试 JSON APIs
Laravel 也提供了几个辅助函数来测试 JSON APIs 及其响应。举例来说，`json`， `get`， `post`， `put`， `patch` 和 `delete` 方法可以用于发出各种 HTTP 动作的请求。你也可以轻松的传入数据或标头到这些方法上。首先，让我们来编写一个测试，将 POST 请求发送至 /user ，并断言其会返回预期数据：
~~~
<?php
class ExampleTest extends TestCase
{
/**
* A basic functional test example.
*
* @return void
*/
public function testBasicExample()
{
$response = $this->json('POST', '/user', ['name' => 'Sally']);
$response
->assertStatus(200)
->assertJson([
'created' => true,
]);
}
}
~~~
> {tip} `assertJson` 方法会将响应转换为数组并且利用 `PHPUnit::assertArraySubset` 方法来验证传入的数组是否在应用返回的 JSON 中。也就是说，即使有其它的属性存在于该 JSON 响应中，但是只要指定的片段存在，此测试仍然会通过。
### 验证完全匹配的 JSON
如果你想验证传入的数组是否与应用程序返回的 JSON **完全** 匹配，你可以使用 `assertExactJson` 方法：
~~~
<?php
class ExampleTest extends TestCase
{
/**
* A basic functional test example.
*
* @return void
*/
public function testBasicExample()
{
$response = $this->json('POST', '/user', ['name' => 'Sally']);
$response
->assertStatus(200)
->assertExactJson([
'created' => true,
]);
}
}
~~~
## 测试文件上传
`Illuminate\Http\UploadedFile` 类提供了一个 `fake` 方法，可用于生成用于测试的模拟文件或图像。这与 `Storage` facade 的 `fake` 方法结合使用，极大地简化文件上传的测试。例如，你可以结合这两个功能轻松测试头像上传表单：
~~~
<?php
namespace Tests\Feature;
use Tests\TestCase;
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;
class ExampleTest extends TestCase
{
public function testAvatarUpload()
{
Storage::fake('avatars');
$response = $this->json('POST', '/avatar', [
'avatar' => UploadedFile::fake()->image('avatar.jpg')
]);
// 断言文件已存储
Storage::disk('avatars')->assertExists('avatar.jpg');
// 断言文件不存在
Storage::disk('avatars')->assertMissing('missing.jpg');
}
}
~~~
#### 自定义模拟文件
当使用 `fake` 方法创建文件时，你可以指定图片的宽度、高度和大小，以便更好的测试你的验证规则：
~~~
UploadedFile::fake()->image('avatar.jpg', $width, $height)->size(100);
~~~
除了创建图片，你还可以使用 `create` 方法创建任何其他类型的文件：
~~~
UploadedFile::fake()->create('document.pdf', $sizeInKilobytes);
~~~
## 可用的断言方法
Laravel 为你的 [PHPUnit](https://phpunit.de/) 测试提供了各种各样的自定义断言方法。`json`， `get`， `post`， `put` 和 `delete`这些测试方法返回的响应都可以使用这些断言方法：
| Method | Description |
| --- | --- |
| `$response->assertStatus($code);` | 断言该响应具有给定的状态码。 |
| `$response->assertRedirect($uri);` | 断言该响应被重定向至指定的 URI。 |
| `$response->assertHeader($headerName, $value = null);` | 断言该响应存在指定的标头。 |
| `$response->assertCookie($cookieName, $value = null);` | 断言该响应包含了指定的 cookie。 |
| `$response->assertPlainCookie($cookieName, $value = null);` | 断言该响应包含了指定的 cookie （未加密）。 |
| `$response->assertSessionHas($key, $value = null);` | 断言该 session 包含指定数据。 |
| `$response->assertSessionHasErrors(array $keys);` | 断言该 session 包含指定字段的错误信息。 |
| `$response->assertSessionMissing($key);` | 断言该 session 不包含指定键。 |
| `$response->assertJson(array $data);` | 断言该响应包含指定 JSON 数据。 |
| `$response->assertJsonFragment(array $data);` | 断言该响应包含指定 JSON 片段。 |
| `$response->assertExactJson(array $data);` | 断言该响应包含完全匹配的 JSON 数据。 |
| `$response->assertJsonStructure(array $structure);` | 断言该响应存在指定 JSON 结构。 |
| `$response->assertViewHas($key, $value = null);` | 断言该响应视图存在指定数据。 |
- 前言
- 翻译说明
- 发行说明
- 升级说明
- 贡献导引
- 入门指南
- 安装
- 配置信息
- 文件夹结构
- 请求周期
- 开发环境部署
- Homestead
- Valet
- 核心概念
- 服务容器
- 服务提供者
- Facades
- Contracts
- HTTP层
- 路由
- 中间件
- CSRF 保护
- 控制器
- 请求
- 响应
- 视图
- Session
- 表单验证
- 前端
- Blade 模板
- 本地化
- 前端指南
- 编辑资源 Mix
- 安全
- 用户认证
- Passport OAuth 认证
- 用户授权
- 加密解密
- 哈希
- 重置密码
- 综合话题
- Artisan 命令行
- 广播系统
- 缓存系统
- 集合
- 错误与日志
- 事件系统
- 文件存储
- 辅助函数
- 邮件发送
- 消息通知
- 扩展包开发
- 队列
- 任务调度
- 数据库
- 快速入门
- 查询构造器
- 分页
- 数据库迁移
- 数据填充
- Redis
- Eloquent ORM
- 快速入门
- 模型关联
- Eloquent 集合
- 修改器
- 序列化
- 测试
- 快速入门
- HTTP 测试
- 浏览器测试 Dusk
- 数据库测试
- 测试模拟器
- 官方扩展包
- Cashier 交易工具包
- Envoy 部署工具
- Scout 全文搜索
- Socialite 社会化登录