Laravel factory 使用指引-有解無憂

如果你想為你的 Laravel 專案寫一些測驗，那么你可能需要在某個時候撰寫一些工廠模式，當我第一次聽到工廠一詞時，我不知道它的含義和作用，更不用說了解它們可以為你的測驗帶來的好處了，

假設你有一個產品 Controller，該控制器具有一種存盤方法來保存新產品的詳細資訊，產品可能具有產品代碼，標題，價格，描述和標簽等屬性，這些都在請求中發送到 store 方法，

如果你想測驗這個 endpoint，可以創建一個屬性陣列，然后在 POST 請求中發送它

$product = [
    'product_code' => 'ABC123',  
    'title' => 'My Amazing Product', 
    'price' => 100, 
    'description' => 'This product will change the way you wash your dishes forever',
    'tagline' => 'Voted best in category'
];

$response = $this->post(route('products.store'), $product);

// 你的斷言
$response->assertSuccessful();

這么做沒問題，

但是如果你想在另一個測驗中使用該 product，比如測驗更新 product，你不得不在下一個測驗方法中復制該陣列，或者可以將其提取到測驗的 setUp () 方法中并使其成為 $this->product 以重復利用，

如果你還有另一個測驗類要測驗將 product 添加到 category 中，那你該怎么辦？怎樣才能重用你的產品代碼？你會如何定義不同模型之間的關系？幸運的是，工廠模式可以解決這些問題，

Creating a factory

你可以通過創建相應的工廠方法來產生你所需要的資料，這里提供了一個 artisan 命令可以幫助你快速的、根據你的模型創建對應的工廠方法，

php artisan make:factory ProductFactory --model=Product

執行上面命令后，你會在 database/factories 目錄下看到一個以你的 Product 模型為基礎的，名為 ProductFactory.php 的檔案，你可以通過自定義欄位名，以及該欄位需要的值來獲取你需要的資料，下面是一個例子：

use Illuminate\Support\Str;
use Faker\Generator as Faker;

$factory->define(App\Product::class, function (Faker $faker) {
    return [
        'product_code' => 'ABC123',
        'title' => 'My Amazing Product', 
        'price' => 100, 
        'description' => 'This product will change the way you wash your dishes forever',
        'tagline' => 'Voted best in category'
    ];
});

使用 Faker 定義假資料

我們可以使用先前定義的陣列中的靜態值，但是模型工廠允許我們使用 Faker 生成一些假資料，這樣每次生成新模型時測驗資料都不一樣，

所以對于商品，我們可以使用 numerify 之類的東西來生成不同的商品編號，這將生成一個以 ABC 開頭的代碼，后跟三位數字，以代替散列，

'product_code' => $faker->numerify('ABC###')

如果我們需要要確保商品編碼唯一，該怎么辦？ Faker 有一個 unique 方法，可以確保生成的內容不在表中存在，

'product_code' => $faker->unique()->numerify('ABC###')

對于標題，我們可以使用 words 方法來生成一些單詞，如果您想要一個單詞陣列，則只需要宣告您想要多少個單詞，但是當我們想要一些產品文本時，我們將 true 添加為第二個引數，

'title' => $faker->words(3, true)

對于價格，我們可以使用 randomNumber 方法，但是作為貨幣，我們可能希望保留數字小數點后兩位，因此我們將使用 randomFloat 方法，我們還需要限制最小值和最大值，因此我們可以將它們作為下兩個引數傳遞，

'price' => $faker->randomFloat(2, 10, 100)

對于商品描述，我們可以再次使用 words 方法并將其長度設定為更大的值，也可以使用 paragraph，但是可以使用 realText 獲得一些看起來更逼真的文本，我們需要設定所需字符的最大長度，可以說，在我們的情況下，最多 200 個字符是可以的，

'description' => $faker->realText(200)

最后，對于品牌，我們可以使用比單詞或真實文本更有趣的東西，稱為流行短語，

'tagline' => $faker->catchPhrase

這是我們更新的 ProductFactory，

use Illuminate\Support\Str;
use Faker\Generator as Faker;

$factory->define(App\Product::class, function (Faker $faker) {
    return [
        'product_code' => $faker->unique()->numerify('ABC###'),
        'title' => $faker->words(3, true), 
        'price' => $faker->randomFloat(2, 10, 100), 
        'description' => $faker->realText(200),
        'tagline' => $faker->catchPhrase
    ];
});

因此，現在我們有了模型工廠，可以通過模型工廠助手來更新測驗以使用它，

$product = factory(\App\Product::class)->make();
$response = $this->post(route('products.store'), $product->toArray());

$response->assertSuccessful();

在此示例中，有兩點需要注意，

首先，我們使用 factory()->make() 而非 factory()->create()，它們可能聽起來很相似，但是 make 將創建一個新的模型供你在測驗中使用，而 create 將創建它并將其持久化到你的資料庫中，如果 product 的代碼中有唯一性驗證，使用 create 可能會導致問題，即當資料庫中已經有對應 product 時 create 操作會失敗，

第二點需要注意的是 $this->post() 期望第二個引數是一個陣列，因此我們必須在末尾使用 $product->toArray() 方法把它從物件轉換成陣列，

工廠狀態

這似乎達到了我們的要求，但是現在我們想給 product 加一個標記表示它缺貨了，將欄位添加到資料庫后，我們可以使用新欄位更新 product 工廠，

'out_of_stock' => $faker->boolean()

這個方法會把缺貨標記隨機設定為 true 或 false，

但是，如果我們想創建一種總是缺貨的 product 怎么辦？一種方法是在測驗中使用工廠助手時覆寫該值，

$product = factory(\App\Product::class)->make(['out_of_stock' => true]);

如果我們想使代碼更具可重用性，我們可以在工廠中創建一個狀態， state 方法將模型設定為第一個引數，將狀態名稱設定為第二個引數，將要覆寫的值設定為第三個引數，

$factory->state(\App\Product::class, 'out_of_stock', [
    'out_of_stock' => true
]);

在我們的測驗中，我們可以呼叫工廠，然后在呼叫 make () 之前應用狀態，

$product = factory(\App\Product::class)->states('out_of_stock')->make();

工廠模式真正強大的地方在于當我們在工廠中具有多個狀態時，它們可以同時應用，例如，如果我們有一個狀態表示某個 product 是免費的，我們可以覆寫它的價格，

$factory->state(\App\Product::class, 'free', [
    'price' => 0.00
]);

所以，當我們想要一個缺貨且免費的 product 時，在測驗中可以對它同時應用這兩種狀態，

$product = factory(\App\Product::class)->states(['out_of_stock', 'free')->make();

制作多個模型

另一個小提示，假如我們想要 10 個 product 而不是 1 個，我們不需要呼叫 10 次工廠，只需要在工廠助手中加一個數量作為第二個引數，它就會自動為我們生成 10 個 product，

$products = factory(\App\Product::class, 10)->make();

工廠中的關系

我們對 product 的測驗進行得很順利，但是現在我們有一個屬于某個 category 下的產品，工廠模式允許我們使用另一個工廠來測驗關系，

將 category 表添加到資料庫中并定義 product 和 category 模型的關系后，我們就可以建立 category 工廠，

php artisan make:factory CategoryFactory --model=Category

為簡單起見，category 只有標題和描述兩個欄位，因此我們可以用 word 生成標題，用 realText 生成描述，

use Illuminate\Support\Str;
use Faker\Generator as Faker;

$factory->define(App\Category::class, function (Faker $faker) {
    return [
        'title' => $faker->word,
        'description' => $faker->realText(100)
    ];
});

現在，我們可以將 category_id 添加到 product 工廠，但是如何將 product 和 category 關聯起來？

如何通過 Factories 創建多條資料

開發中，我們可能需要獲取多條資料，這時候可以通過傳遞 factory 第二個引數來實作，下面是例子：

$products = factory(\App\Product::class, 10)->make();

如何通過 Factories 創建有關聯的資料

現在產品資料的產生已經沒什么問題了，但是現在我們想要獲取某個分類下的資料，要怎么辦呢？在 Factories 中我們可以使用另一個工廠類來達到資料關聯的效果，

為了獲取某分類下的產品，我們需要一個 category 工廠類來創建相應的 category 資料，我們可以通過以下命令創建對應的工廠類：

php artisan make:factory CategoryFactory --model=Category

為了演示方便，我們的 category 只需要標題和描述兩個欄位，我們可以用 $faker->word 創建標題資料，用 $faker->realText(100) 來創建描述資料，

use Illuminate\Support\Str;
use Faker\Generator as Faker;

$factory->define(App\Category::class, function (Faker $faker) {
    return [
        'title' => $faker->word,
        'description' => $faker->realText(100)
    ];
});

現在我們已經通過 category 工廠類來產生分類資料，但是要如何將產品和分類資料關聯呢？

我們可以使用剛在 Product factory 中創建的工廠，而不是像其他欄位那樣使用 faker，

use Illuminate\Support\Str;
use Faker\Generator as Faker;

$factory->define(App\Product::class, function (Faker $faker) {
    return [
        'product_code' => $faker->unique()->numerify('ABC###'),
        'title' => $faker->words(3, true), 
        'price' => $faker->randomFloat(2, 10, 100), 
        'description' => $faker->realText(200),
        'tagline' => $faker->catchPhrase,
        'out_of_stock' => $faker->boolean,
        'category_id' => factory(\App\Category::class)
    ];
});

它知道它需要 ID，因此你不需要使用 factory()->create() 或者 factory()->create()->id 獲取類別 ID，

現在，當你運行創建產品的測驗時，它知道該產品應該屬于某個類別并為你創建類別，而無需你在測驗中做任何額外的操作，

如果對于特定的測驗場景，你想創建屬于某個類別的產品，則可以先定義類別，然后覆寫產品上的類別 id，使其成為你剛剛創建的類別，

$category = factory(\App\Category::class)->create();

$products = factory(\App\Product::class, 10)->create(['category_id' => $category->id]);

然后就可以斷言該類別有 10 個產品

$this->assertEquals(10, $category->fresh()->products->count());

希望本文能為你提供一些關于工廠測驗的想法，幫你開始在測驗中使用工廠，并使將來撰寫測驗變得更加容易，

更多學習內容請訪問：

騰訊T3-T4標準精品PHP架構師教程目錄大全，只要你看完保證薪資上升一個臺階（持續更新）?zhuanlan.zhihu.com

轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/49460.html

標籤：PHP

上一篇：Leetcode 5. 最長回文子串

下一篇：PHP7.4 全新擴展方式 FFI 詳解