數(shù)據(jù)庫測試
數(shù)據(jù)庫測試
Database Testing
簡介
Laravel 提供了各種有用的工具,可以更輕松地測試數(shù)據(jù)庫驅(qū)動的應(yīng)用程序。 首先,您可以使用 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)置斷言方法來補(bǔ)充您的測試。
生成模型工廠
使用 make:factory
Artisan command 命令可以創(chuàng)建一個模型工廠:
php artisan make:factory PostFactory
新生成的工廠位置在 database/factories
目錄下。
--model
選項可用于指示工廠創(chuàng)建的模型的名稱。 此選項將使用給定模型預(yù)填充生成的工廠文件:
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 模型 定義一組默認(rèn)屬性。 開始測試前,請查看應(yīng)用程序中的 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 中,您可以返回模型上所有屬性的默認(rèn)測試值。 Closure 將收到 Faker PHP 庫的一個實例,它允許您方便地生成各種隨機(jī)數(shù)據(jù)以進(jìn)行測試。
您還可以為每個模型創(chuàng)建其他工廠文件,以便更好地進(jìn)行組織。 例如,您可以在 database / factories
目錄中創(chuàng)建 UserFactory.php
和 CommentFactory.php
文件。 factories
目錄中的所有文件都將由 Laravel 自動加載。
您可以通過在
config / app.php
配置文件中添加faker_locale
選項來設(shè)置 Faker 的語言環(huán)境。
工廠狀態(tài)
States 允許您定義可以任意組合應(yīng)用于模型工廠的離散修改。 例如,您的 User
模型可能具有 deinquent
狀態(tài),可以修改其默認(rèn)屬性值之一。 您可以使用 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í)行其他任務(wù)。 例如,您可以使用回調(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();
應(yīng)用狀態(tài)
您也可以將任何 states 應(yīng)用于模型。 如果要將多個狀態(tài)轉(zhuǎn)換應(yīng)用于模型,則應(yīng)指定要應(yīng)用的每個狀態(tài)的名稱:
$users = factory(App\User::class, 5)->states('delinquent')->make(); $users = factory(App\User::class, 5)->states('premium', 'delinquent')->make();
覆蓋屬性
如果要覆蓋模型的某些默認(rèn)值,可以將一組值傳遞給 make
方法。 只有指定的值才會被替換,而其余值仍然設(shè)置為工廠指定的默認(rèn)值:
$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)系。 當(dāng)使用 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ù)庫斷言方法:
方法 | 描述 |
---|---|
$this->assertDatabaseHas($table, array $data); | 斷言數(shù)據(jù)庫表中包含給定的數(shù)據(jù)。 |
$this->assertDatabaseMissing($table, array $data); | 斷言數(shù)據(jù)庫表中不包含給定的數(shù)據(jù)。 |
$this->assertSoftDeleted($table, array $data); | 斷言數(shù)據(jù)庫中的指定記錄已軟刪除。 |