Laravel應(yīng)用程序中怎么使用模型工廠

 declare(strict_types=1);

namespace App\Publishing\Enums;

enum PostStatus: string
{
    case PUBLISHED = 'published';
    case DRAFT = 'draft';
    case QUEUED = 'queued';
}

現(xiàn)在，讓我們回到我們在這里討論的主題：模型工廠。一個簡單的工廠看起來很簡單：

 declare(strict_types=1);

namespace Database\Factories;

use App\Models\Post;
use App\Publishing\Enums\PostStatus;
use Illuminate\Database\Eloquent\Factories\Factory;
use Illuminate\Support\Arr;
use Illuminate\Support\Str;

class PostFactory extends Factory
{
    protected $model = Post::class;

    public function definition(): array
    {
        $title = $this->faker->sentence();
        $status = Arr::random(PostStatus::cases());

        return [
            'title' => $title,
            'slug' => Str::slug($title),
            'content' => $this->faker->paragraph(),
            'status' => $status->value,
            'published_at' => $status === PostStatus::PUBLISHED
                ? now()
                : null,
        ];
    }
}

所以在我們的測試中，我們現(xiàn)在可以快速調(diào)用我們的 post factory 為我們創(chuàng)建一個 post。讓我們看看我們可以如何做到這一點(diǎn)：

it('can update a post', function () {
    $post = Post::factory()->create([
        'type' => PostStatus::DRAFT->value,
    ]);

    putJson(
        route('api.posts.update', $post->slug),
        ['content' => 'test content',
    )->assertSuccessful();

    expect(
        $post->refresh()
    )->content->toEqual('test content');
});

完美，我們可以將一個參數(shù)傳遞給 create 方法，以確保我們在創(chuàng)建它時設(shè)置正確的類型，這樣我們的業(yè)務(wù)規(guī)則就不會抱怨。但是這樣寫有點(diǎn)麻煩，所以讓我們稍微重構(gòu)一下我們的工廠，添加修改狀態(tài)的方法：

 declare(strict_types=1);

namespace Database\Factories;

use App\Models\Post;
use App\Publishing\Enums\PostStatus;
use Illuminate\Database\Eloquent\Factories\Factory;
use Illuminate\Support\Str;

class PostFactory extends Factory
{
    protected $model = Post::class;

    public function definition(): array
    {
        $title = $this->faker->sentence();

        return [
            'title' => $title,
            'slug' => Str::slug($title),
            'content' => $this->faker->paragraph(),
            'status' => PostStatus::DRAFT->value,
            'published_at' => null,
        ];
    }

    public function published(): static
    {
        return $this->state(
            fn (array $attributes): array => [
                'status' => PostStatus::PUBLISHED->value,
                'published_at' => now(),
            ],
        );
    }
}

我們?yōu)楣S設(shè)置了默認(rèn)值，以便所有新創(chuàng)建的帖子都是草稿。然后我們添加一個設(shè)置要發(fā)布的狀態(tài)的方法，它將使用正確的 Enum 值并設(shè)置發(fā)布日期 - 在測試環(huán)境中更具可預(yù)測性和可重復(fù)性。讓我們看看我們的測試現(xiàn)在是什么樣子：

 it('returns an error when trying to update a published post', function () {
    $post = Post::factory()->published()->create();

    putJson(
        route('api.posts.update', $post->slug),
        ['content' => 'test content',
    )->assertStatus(Http::UNPROCESSABLE_ENTITY());

    expect(
        $post->refresh()
    )->content->toEqual($post->content);
});

這次我們正在測試當(dāng)我們嘗試更新已發(fā)布的帖子時是否收到驗(yàn)證錯誤狀態(tài)。這可確保我們保護(hù)我們的內(nèi)容并在我們的應(yīng)用程序中強(qiáng)制執(zhí)行特定的工作流程。

 it('can update a draft posts title', function () {
    $post = Post::factory()->title('test')->create();

    putJson(
        route('api.posts.update', $post->slug),
        ['title' => 'new title',
    )->assertSuccessful();

    expect(
        $post->refresh()
    )->title->toEqual('new title')->slug->toEqual('new-title');
});

所以我們可以很好地使用工廠狀態(tài)來控制我們的測試環(huán)境中的東西，給我們盡可能多的控制權(quán)。這樣做將確保我們始終如一地準(zhǔn)備測試，或者很好地反映特定點(diǎn)的應(yīng)用程序狀態(tài)。

Post::factory()->count(12)->create();

但是，在我們的應(yīng)用程序中，有時我們可能希望以特定順序運(yùn)行事物。假設(shè)我們希望第一個是草稿，但第二個已發(fā)布？

 it('shows the correct status for the posts', function () {
    Post::factory()
        ->count(2)
        ->state(new Sequence(
            ['status' => PostStatus::DRAFT->value],
            ['status' => PostStatus::PUBLISHED->value],
        ))->create();

    getJson(
        route('api.posts.index'),
    )->assertOk()->assertJson(fn (AssertableJson $json) =>
        $json->where('id', 1)
            ->where('status' PostStatus::DRAFT->value)
            ->etc();
    )->assertJson(fn (AssertableJson $json) =>
        $json->where('id', 2)
            ->where('status' PostStatus::PUBLISHED->value)
            ->etc();
    );
});