Database Testing

• 簡介
• 生成模型工廠
• 每次測試后重置數(shù)據(jù)庫
• 寫作工廠
  • 工廠狀態(tài)
  • 工廠回調(diào)
• 在測試中使用模型工廠
  • 創(chuàng)建模型
  • 持久化模型
  • 模型關(guān)聯(lián)
• 可用的斷言方法

簡介

Laravel 提供了各種有用的工具，可以更輕松地測試數(shù)據(jù)庫驅(qū)動的應用程序。 首先，您可以使用 assertDatabaseHas 幫助程序斷言數(shù)據(jù)庫中存在的數(shù)據(jù)與給定的一組條件匹配。 例如，如果您要驗證 users 表中的記錄是否具有 sally @ example.com 的 email 值，您可以執(zhí)行以下操作：

public function testDatabase(){ 
   // Make call to application...    
   $this->assertDatabaseHas('users', [    
       'email' => 'sally@example.com'   
     ]);
  }

您還可以使用 assertDatabaseMissing 幫助程序斷言數(shù)據(jù)庫中不存在數(shù)據(jù)。

assertDatabaseHas 方法和其他類似的幫助程序是為了方便起見。 您可以自由使用任何 PHPUnit 的內(nèi)置斷言方法來補充您的測試。

生成模型工廠

使用 make:factory  Artisan command 命令可以創(chuàng)建一個模型工廠：

php artisan make:factory PostFactory

新生成的工廠位置在 database/factories 目錄下。

--model 選項可用于指示工廠創(chuàng)建的模型的名稱。 此選項將使用給定模型預填充生成的工廠文件：

php artisan make:factory PostFactory --model=Post

每次測試后重置數(shù)據(jù)庫

在每次測試后重置數(shù)據(jù)庫通常很有用，這樣前一次測試的數(shù)據(jù)不會干擾后續(xù)測試。 RefreshDatabase 特征采用最優(yōu)化的方法來遷移測試數(shù)據(jù)庫，具體取決于您使用的是內(nèi)存數(shù)據(jù)庫還是傳統(tǒng)數(shù)據(jù)庫。 在測試類上使用特征，一切都將為您處理：

<?php
    namespace Tests\Feature;
    use Tests\TestCase;
    use Illuminate\Foundation\Testing\RefreshDatabase;
    use Illuminate\Foundation\Testing\WithoutMiddleware;
    class ExampleTest extends TestCase{   
     use RefreshDatabase;   
      /**
     * 一個基本功能測試示例
     *
     * @return void
     */   
     public function testBasicExample()  
       {       
        $response = $this->get('/');    
            // ...   
        }
     }

創(chuàng)建模型工廠

測試時，您可能需要在執(zhí)行測試之前將幾條記錄插入數(shù)據(jù)庫。 在創(chuàng)建此測試數(shù)據(jù)時， Laravel 不是手動指定每列的值，而是允許您使用模型工廠為每個 Eloquent 模型 定義一組默認屬性。 開始測試前，請查看應用程序中的 database / factories / UserFactory.php 文件。 開箱即用，此文件包含一個工廠定義：

use Illuminate\Support\Str;
use Faker\Generator as Faker;
$factory->define(App\User::class, function (Faker $faker) { 
   return [    
       'name' => $faker->name,        
       'email' => $faker->unique()->safeEmail,        
       'email_verified_at' => now(),        
       'password' => '$2y$10$TKh8H1.PfQx37YgCzwiKb.KjNyWgaHb9cbcoQgdIVFlYg7B77UdFm', 
       // secret        
       'remember_token' => Str::random(10),    
       ];
   });

在用作工廠定義的 Closure 中，您可以返回模型上所有屬性的默認測試值。  Closure 將收到 Faker PHP 庫的一個實例，它允許您方便地生成各種隨機數(shù)據(jù)以進行測試。

您還可以為每個模型創(chuàng)建其他工廠文件，以便更好地進行組織。 例如，您可以在 database / factories 目錄中創(chuàng)建 UserFactory.php 和 CommentFactory.php 文件。  factories 目錄中的所有文件都將由 Laravel 自動加載。

您可以通過在 config / app.php 配置文件中添加 faker_locale 選項來設(shè)置 Faker 的語言環(huán)境。

工廠狀態(tài)

States 允許您定義可以任意組合應用于模型工廠的離散修改。 例如，您的 User 模型可能具有 deinquent 狀態(tài)，可以修改其默認屬性值之一。 您可以使用 state 方法定義狀態(tài)轉(zhuǎn)換。 對于簡單狀態(tài)，您可以傳遞一組屬性修改：

$factory->state(App\User::class, 'delinquent', [
    'account_status' => 'delinquent',
   ]);

如果你的狀態(tài)需要計算或 $ faker 實例，你可以使用 Closure 來計算狀態(tài)的屬性修改：

$factory->state(App\User::class, 'address', function ($faker) {
    return [      
      'address' => $faker->address,  
        ];
    });

工廠回調(diào)

使用 afterMaking 和 afterCreating 方法注冊工廠回調(diào)，并允許您在創(chuàng)建或創(chuàng)建模型后執(zhí)行其他任務。 例如，您可以使用回調(diào)將其他模型與創(chuàng)建的模型相關(guān)聯(lián)：

$factory->afterMaking(App\User::class, function ($user, $faker) {
    // ...
   });
$factory->afterCreating(App\User::class, function ($user, $faker) { 
   $user->accounts()->save(factory(App\Account::class)->make());
 });

您還可以為 工廠狀態(tài) 定義回調(diào)：

$factory->afterMakingState(App\User::class, 'delinquent', function ($user, $faker) { 
   // ...
 });
$factory->afterCreatingState(App\User::class, 'delinquent', function ($user, $faker) {
    // ...
 });

使用模型工廠

創(chuàng)建模型

模型工廠定義后，就可以在測試或種子文件中使用全局 factory 函數(shù)來生成模型實例。 那么，讓我們來看一些創(chuàng)建模型的例子。 首先，我們將使用 make 方法創(chuàng)建模型，但不將它們保存到數(shù)據(jù)庫中：

public function testDatabase(){
    $user = factory(App\User::class)->make();    
    //在測試中使用模型...
  }

您還可以創(chuàng)建許多模型的集合或創(chuàng)建給定類型的模型：

//創(chuàng)建三個 App\User 實例...
$users = factory(App\User::class, 3)->make();

應用狀態(tài)

您也可以將任何 states 應用于模型。 如果要將多個狀態(tài)轉(zhuǎn)換應用于模型，則應指定要應用的每個狀態(tài)的名稱：

$users = factory(App\User::class, 5)->states('delinquent')->make();
$users = factory(App\User::class, 5)->states('premium', 'delinquent')->make();

覆蓋屬性

如果要覆蓋模型的某些默認值，可以將一組值傳遞給 make 方法。 只有指定的值才會被替換，而其余值仍然設(shè)置為工廠指定的默認值：

$user = factory(App\User::class)->make([
    'name' => 'Abigail',
  ]);

持久化模型

create 方法不僅創(chuàng)建了模型實例，還使用 Eloquent 的 save 方法將它們保存到數(shù)據(jù)庫中：

public function testDatabase(){ 
   // 創(chuàng)建單個 App\User 實例...    
   $user = factory(App\User::class)->create();    
   // 創(chuàng)建3個 App\User 實例..    
   $users = factory(App\User::class, 3)->create();   
    // 在測試中使用模型...
  }

您可以通過將數(shù)組傳遞給 create 方法來覆蓋模型上的屬性：

$user = factory(App\User::class)->create([
    'name' => 'Abigail',
  ]);

關(guān)聯(lián)

在這個例子中，我們將附加一些創(chuàng)建模型的關(guān)系。 當使用 create 方法創(chuàng)建多個模型時，返回一個 Eloquent  集合實例 ，這樣就可以在集合上使用 each 等便利方法：

$users = factory(App\User::class, 3)   
        ->create()           
        ->each(function ($user) {       
                 $user->posts()->save(factory(App\Post::class)->make());           
           });

關(guān)聯(lián) & 屬性閉包

您還可以使用工廠定義中的 Closure 屬性將關(guān)系附加到模型。 例如，如果您想在創(chuàng)建 Post 時創(chuàng)建一個新的 User 實例，您可以執(zhí)行以下操作：

$factory->define(App\Post::class, function ($faker) { 
   return [    
       'title' => $faker->title,        
       'content' => $faker->paragraph,        
       'user_id' => function () {      
             return factory(App\User::class)->create()->id;   
                  }  
             ];
        });

這些閉包接收一個包含工廠屬性的數(shù)組：

$factory->define(App\Post::class, function ($faker) {
    return [   
         'title' => $faker->title,        
         'content' => $faker->paragraph,        
         'user_id' => function () {    
                 return factory(App\User::class)->create()->id;    
                  },        
          'user_type' => function (array $post) {   
                   return App\User::find($post['user_id'])->type;     
                   }   
            ];
      });

可用的斷言方法

Laravel 為 PHPUnit 測試提供了多個數(shù)據(jù)庫斷言方法：