Laravel应用程序中怎么使用模型工厂

declare(strict_types=1);

namespaceAppModels;

useAppPublishingEnumsPostStatus;
useIlluminateDatabaseModel;

classPostextendsModel
{
protected$fillable=[
'title',
'slug',
'content',
'status',
'published_at',
];

protected$casts=[
'status'=>PostStatus::class,
'published_at'=>'datetime',
];
}

正如你在此处看到的，我们有一个用于状态列的 Enum，我们现在将对其进行设计。在这里使用枚举允许我们利用 PHP 8.1 的特性，而不是纯字符串、布尔标志或混乱的数据库枚举。

declare(strict_types=1);

namespaceAppPublishingEnums;

enumPostStatus:string
{
casePUBLISHED='published';
caseDRAFT='draft';
caseQUEUED='queued';
}

现在，让我们回到我们在这里讨论的主题：模型工厂。一个简单的工厂看起来很简单：

declare(strict_types=1);

namespaceDatabaseFactories;

useAppModelsPost;
useAppPublishingEnumsPostStatus;
useIlluminateDatabaseEloquentFactoriesFactory;
useIlluminateSupportArr;
useIlluminateSupportStr;

classPostFactoryextendsFactory
{
protected$model=Post::class;

publicfunctiondefinition():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,
];
}
}

所以在我们的测试中，我们现在可以快速调用我们的 post factory 为我们创建一个免费云主机域名 post。让我们看看我们可以如何做到这一点：

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

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

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

完美，我们可以将一个参数传递给 create 方法，以确保我们在创建它时设置正确的类型，这样我们的业务规则就不会抱怨。但是这样写有点麻烦，所以让我们稍微重构一下我们的工厂，添加修改状态的方法：

declare(strict_types=1);

namespaceDatabaseFactories;

useAppModelsPost;
useAppPublishingEnumsPostStatus;
useIlluminateDatabaseEloquentFactoriesFactory;
useIlluminateSupportStr;

classPostFactoryextendsFactory
{
protected$model=Post::class;

publicfunctiondefinition():array
{
$title=$this->faker->sentence();

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

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

我们为工厂设置了默认值，以便所有新创建的帖子都是草稿。然后我们添加一个设置要发布的状态的方法，它将使用正确的 Enum 值并设置发布日期 - 在测试环境中更具可预测性和可重复性。让我们看看我们的测试现在是什么样子：

it('returnsanerrorwhentryingtoupdateapublishedpost',function(){
$post=Post::factory()->published()->create();

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

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

这次我们正在测试当我们尝试更新已发布的帖子时是否收到验证错误状态。这可确保我们保护我们的内容并在我们的应用程序中强制执行特定的工作流程。

declare(strict_types=1);

namespaceDatabaseFactories;

useAppModelsPost;
useAppPublishingEnumsPostStatus;
useIlluminateDatabaseEloquentFactoriesFactory;
useIlluminateSupportStr;

classPostFactoryextendsFactory
{
protected$model=Post::class;

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

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

publicfunctiontitle(string$title):static
{
return$this->state(
fn(array$attributes):array=>[
'title'=>$title,
'slug'=>Str::slug($title),
],
);
}
}

因此，在我们的测试中，我们可以创建一个新测试，以确保我们可以通过我们的 API 更新草稿帖子标题：

it('canupdateadraftpoststitle',function(){
$post=Post::factory()->title('test')->create();

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

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

所以我们可以很好地使用工厂状态来控制我们的测试环境中的东西，给我们尽可能多的控制权。这样做将确保我们始终如一地准备测试，或者很好地反映特定点的应用程序状态。

it('listsallposts',function(){
Post::factory(12)->create();

getJson(
route('api.posts.index'),
)->assertOk()->assertJson(fn(AssertableJson$json)=>
$json->has(12)->etc(),
);
});

所以我们正在创建 12 个新帖子，并确保当我们获得索引路由时，我们有 12 个帖子返回。除了将 count 传递给工厂方法，你还可以使用 count 方法：

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

但是，在我们的应用程序中，有时我们可能希望以特定顺序运行事物。假设我们希望第一个是草稿，但第二个已发布？

it('showsthecorrectstatusfortheposts',function(){
Post::factory()
->count(2)
->state(newSequence(
['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();
);
});