Laravelでのテスト構成

環境

PHP7.1
Laravel 5.6
MySQL

お聞きしたいこと

現在Laravelで、アプリケーションの開発を始め、今まで開発で不覚にもテストを書いたことがなく、テストを書いてみたいと思っています。
使用するテストツールはLaravelに標準搭載のPHPUnitを使用しようと考えています。

デフォルトでは、testsディレクトリ配下に、Featureディレクトリ、Unitディレクトリ、CreatesApplication.php、TestCase.phpというファイルが存在しています。

公式ドキュメントやweb上を検索して見たのですが、実務的なテストディレクトリの構成に関するものが出てこず、実際にLaravelを書いている方たちはどのような構成でテストを書いているのかお聞きしたいです。

また、テスト自体に関してもあまり理解出来ておらず、具体的にどのようなことをテストでやるかについても補足いただけますと幸いです。。。

行動規範の内容に同意します

回答1件

ベストアンサー

基本的には標準のテストフォルダの構成を守っています。
分かり易いように更に機能ごとにフォルダを分けるのはアリかと思います。(tests/Unit/User/ユーザーに関するテスト群の様なイメージ)

どのようなことをテストでやるか

凄く幅の広い質問かと思いますが、作成した機能が期待した動作をするかを確認しますよね？
例えばですが、CSVを取り込んで配列にする場合には、下記の様なテストを書いています。

php
1$CSV      = new CSV();
2$fullPath = base_path('tests/unit/testdata/TestConvertArray.csv');//ここにテストデータを置いておく
3$testPath = $fullPath.'.test';
4copy($fullPath,$testPath);
5$assertValue = $CSV->convertToArray($testPath);
6unlink($testPath);
7$this->assertEquals([
8    ['col1'=>'1','col2'=>'2','col3'=>'3','col4'=>'4'],
9    ['col1'=>'日本語','col2'=>'6','col3'=>'7','col4'=>'8'],
10],$assertValue);

DBへのIOなんかもassertDatabaseHasでテストできるので、単機能のテストはUnit配下に置いてテストしています。

FeatureディレクトリはHTTPベースでのテストが出来るので、同じくCSVをダウンロードする機能という
場合には下記の様に書いています。

php
1    /**
2     * CSVファイルのダウンロードを検証する。
3     *
4     * @return void
5     */
6    public function testExample()
7    {
8        $CSV = new CSV();
9        $header = ['A','B','C'];
10        $list   = [['D','E','F'],['G','H','I']];
11        $filename = 'test.csv';
12        $response = $CSV->download($list, $header, $filename);
13
14        $this->assertEquals(200, $response->status());
15        $this->assertEquals("A,B,C\nD,E,F\nG,H,I\n", $response->content());
16        
17    }