Fukuoka.php Vol.17 ～Rebooted～
Laravelとテストについて
株式会社エクスチェンジ ソリューションズ
野田 健夫
2016.06.22
Copyright © Xchange Solutions Al right reserved.

こんにちは！
2
野田 健夫（のだたけお）
https://twitter.com/nodatakeo
https://www.facebook.com/nodatakeo
株式会社エクスチェンジ ソリューションズ

今日の内容
3
1.
開発者に立ちはだかるテストの壁
2.
なぜテストをやるのか？
3.
テストの種類
4.
テストへのジレンマ
5.
Laravelテスト
環境構築
API編
ウェブページ編
その他
6.
まとめ

開発者に立ちはだかるテストの壁
4
環境作るのが面倒くさい。
実装に比べて生産的でない感じがする。
単体テストはともかくとして、シナリオ
テストが作りにくい。
時間がない。

なぜテストをやるのか？
5
利用可能な状態を担保するため。
要件を満たしているか確認するため。
品質を高め、信頼性を上げるため。
システムが動かなかったり、品質が低いと
利用者・顧客の不利益になる。その
リカバリーにかかる作業コストも大きい。

テストの種類
6
※ウェブアプリケーションでの例
メソッド・関数の期待値検査
単体テスト
→xUnitテスト
これまでテスト自動化に悩んでいた領域
APIスキーマ・HTMLコンテンツチェック
結合テスト
シナリオテスト・脆弱性テスト
システムテスト
パフォーマンス、ログ、サーバー周りなど
→debugbar、slowログ、jmeter、zabbixなど

テストへのジレンマ
7
テストの必要性は理解しているけど、コスト高い
のでは？
自動テストでできる検査って、ロジック以下の
assertHoge系の値検査ぐらいしかなかったっけ？
調べてみたらLaravelでいろいろテストを
支援する仕組みが用意されていた。

Laravelのテスト: phpunit
8
よく使われているphpunitでのテストを
ベースとしている。
./tests 以下のテストケースをすべて実行する。
composer dump-autoload
./vendor/phpunit/phpunit/phpunit tests
./tests 以下のテストケースのうち特定のテストクラスでfilterして実行する。
composer dump-autoload
./vendor/phpunit/phpunit/phpunit --filter 'testContent' tests/api/ApiContentControllerTest.php

Laravelのテスト: 環境構築(Fixture)
9
テストのフィクスチャ(Fixture:ベースとなるデー
タ設定)に Seederを使う。
過去の案件では、.envのAPP_ENVをみて、環境ごとに切り替えれるSeederを用意。
class ContentSeeder extends BaseSeeder
abstract class BaseSeeder extends Seeder
{
{
/**
/**
* Run the database seeds.
* Get default seeds by table name
*
* @param $target table name
* @return void
* @return void
*/
*/
public function run()
public function getConfig($target)
{
{
//削除
$config = require(base_path('database/seeds/default_'. config('app.env') . '.php'));
Content::truncate();
return array_get($config, $target);
}
// コンテンツのデータ追加
}
foreach ($this->getConfig('contents') as $record) {
$dao = new Content ();
$dao->setUpRecord($record);
$dao->save();
}
テストの初期状態を共有
}
}

Laravelのテスト: APIスキーマチェック
10
seeJsonStructureメソッド
キー名の配列を渡して構造をチェック
assertResponseStatus/assertResponseOkメソッド
HTTPステータスコードをチェック
// JSONパラメータ
// JSON構造のチェック
$content = [];
$this->seeJsonStructure([
// メソッド
'error',
$method = 'GET';
‘content_list' => [
// URL
'*' => [
$url = route("contents.get");
'id',
'title',
// サーバー環境変数
],
$server = $this->getServerParameter($method, $url);
],
]);
// JSONでAPIを呼び出し
// ステータスコードのチェック
$this->withServerVariables($server)
$this->assertResponseStatus(200);
->json($method, $url, $content, $server);
// レスポンス状態のチェック
$this->assertResponseOk();

Laravelのテスト: API値チェック
11
seeメソッド
レスポンス中に値が含まれるか検査が可能。
$this->see('Laravel 5');
responseプロパティ
レスポンス自体も取得できるので、値を抜き出せば、従来のassert
チェックも可能。
$response = json_decode($this->response->content(), true);
$this->assertEquals('Laravel 5', $response['title']);

Laravelのテスト: WEBコンテンツチェック
12
visitメソッド
$this->visit(route('admin.logout'));
URLにアクセス。
$this->visit(route('admin.login'));
$this->type('a@aaa.com', 'login_id');
typeメソッド
$this->type('testpw123', 'login_pw');
指定IDフォームに入力。
$this->press('action');
$this->seePageIs(route('admin.top'));
pressメソッド
$this->see('TOPページ');
指定IDボタンを押下。
シナリオテストの動作チェックが可能。
seePageIsメソッド
現在URL値をチェック。

13
Chrome Extension: Laravel TestTools

14
Chrome Extension: Laravel TestTools
開発ツール(ctrl+shift+i)のタブに「Laravel TestTools」が追加。
Selenium IDEの記録のような形で[Record]ボタンを押下すると
テストコードが生成されます。

DB値のチェック
15
seeInDatabaseメソッド
テーブル内に指定したキーのレコードがあるかチェック。
$this->seeInDatabase('users', ['email' => 'sally@example.com']);

Test用Trait
16

Illuminate/Foundation/Testing/DatabaseMigrations.php (Trait)

テスト開始時にマイグレーションを実行し、終了後にマイグレーションロールバックする。

Illuminate/Foundation/Testing/DatabaseTransactions.php (Trait)

テスト開始時にトランザクションを開始し、終了後にロールバックする。

Illuminate/Foundation/Testing/WithoutEvents.php (Trait)

すべてのイベントを抑止して余計な処理を発生させない。

Illuminate/Foundation/Testing/WithoutMiddleware.php (Trait)

すべてのミドルウェアを抑止して余計な処理を発生させない。

Illuminate/Foundation/Testing/Conserns/* (Trait)

テスト向けの各種実装。see*系(seeJsonStructureなど)は、ほかのフレームワークでも参考になると
思います。

まとめ
17
テスト自動化は、テストの壁を低くする。
開発してリリースしておしまいでなく、開発が継続する案件
が増えている。デグレを避けるためにも必須になりつつある
ように感じている。
フレームワークが持っているテストの仕組みを使うことでAPI
スキーマテストやシナリオテストといったより複雑なテスト
自動化をシンプルに行うことができる。
テストは放っておくと腐る。テストが適切に行われるよう仕
様変更や動作が変わった場合は、メンテナンスを必ず行う。

番外編：GuzzleでAPI/シナリオテスト
18
GuzzleもAPIクライアントとしてだけでなく
テストにもシンプルで使い易いと思います。
public function __construct()
{ $this->endPoint = "https://hoge.jp";
$this->client = new HttpClient($this->endPoint);
}
/**
* OAuth 認証ページテスト
* @Test
*/
public function testAuthorization() {
$this->endPoint = “https://hogehoge.jp”;
$this->client = new HttpClient($this->endPoint);
// rfc6570
$uri = array(‘/auth/authorize?response_type={response_type}&client_id={client_id}&state={state}’,
array(‘response_type’ => ‘code’, ‘client_id’ => ‘demoapp’, ‘state’ => session_id()));
// リクエストを作成
$request = $this->client->get($uri);
// レスポンスを取得
$response = $request->send();
// 値検査
$this->assertEquals(200, $response->getStatusCode());
}

番外編：テストを取り巻く技術要素
19
単体テスト
PHPUnit
Framework Unit Testing
Library Unit Testing
結合テスト
Behat/Mink/PHPSpec
BDD
Selenium
※どこまでテストケースに書くかは案件内容と設計内容による。