Laravel模型工厂状态使用教程【测试】

Laravel模型工厂的状态方法（如published()、admin()）是高效构建多样化测试数据的核心技巧——它允许你为同一模型灵活注入不同业务状态（如“已发布”“草稿”“管理员用户”），通过在工厂类中定义返回$this->state([...])的链式调用方法，轻松实现字段覆盖、动态计算、枚举值精准写入，并在测试和Seeder中无缝复用；无论你是想验证权限逻辑、状态流转，还是批量初始化多态数据，掌握这一机制都能让你告别硬编码、避免数据污染，写出更清晰、可靠且可维护的Laravel测试与填充代码。

如果您在 Laravel 测试中需要为同一模型生成不同业务状态的数据（如“已发布”、“草稿”、“管理员用户”），但发现所有记录都使用默认定义，无法区分行为逻辑，则很可能是未正确使用模型工厂的状态方法。以下是实现该目标的具体方式：

一、定义状态方法

状态方法用于在不修改基础 definition() 的前提下，为模型实例注入特定字段值或逻辑分支，适用于需覆盖默认值、模拟枚举状态、设置布尔标志等场景。每个状态方法应返回 $this->state([...])，且可链式调用。

1、在对应工厂类（如 PostFactory.php）中，于 definition() 方法之后添加一个 public 方法，例如 published()；

2、该方法内调用 $this->state() 并传入需覆盖的字段数组，如 ['status' => 'published', 'published_at' => now()]；

3、确保该方法返回 $this->state(...) 的结果，以支持链式语法；

4、若需动态计算字段（如根据当前状态推导 slug），可在 state 闭包中使用 function(array $attributes) 形式访问上下文。

二、调用单个状态

当测试某一种明确状态的业务流程时（如验证“仅已发布文章可被公开访问”），应直接通过链式调用应用状态方法，避免污染其他测试用例的数据特征。

1、在测试文件中使用 Post::factory()->published()->create() 创建一条已发布文章；

2、若工厂类未自动识别，需确认命名是否为 PostFactory 且位于 database/factories 目录下；

3、调用后返回的模型实例将具备 published_at 字段非空、status 值为 'published'，且不会触发 definition() 中的 optional() 或 null 默认逻辑。

三、组合多个状态

当业务规则依赖叠加条件（如“高级管理员发布的已审核文章”），可连续调用多个状态方法，Laravel 会按顺序合并字段值，后调用的状态优先级更高，可覆盖前序状态中相同键的值。

1、定义 admin() 状态方法，设置 is_admin => true 和 level => 'senior'；

2、定义 verified() 状态方法，设置 email_verified_at => now()；

3、在测试中执行 User::factory()->admin()->verified()->create()；

4、最终生成的用户将同时具备 is_admin、level、email_verified_at 三个字段，且无字段冲突。

四、使用状态处理枚举字段

当模型使用 PHP 枚举（如 PostStatus::class）作为字段类型时，状态方法能确保枚举值被准确写入数据库，避免因字符串硬编码导致的类型不匹配或迁移失败。

1、在 factory 文件中 use App\Publishing\Enums\PostStatus；

2、定义 unpublished() 状态：return $this->state(['status' => PostStatus::DRAFT->value, 'published_at' => null])；

3、测试中调用 Post::factory()->unpublished()->create()；

4、生成的记录 status 字段值严格等于 PostStatus::DRAFT->value，而非任意字符串 'draft'。

五、在 Seeder 中复用状态

当需在数据库填充阶段批量生成多类状态数据（如初始化 20 条草稿、10 条已发布、5 条待审核文章），Seeder 是集中管理状态调用的理想位置，避免测试代码重复。

1、在 DatabaseSeeder.php 或自定义 seeder 类中引入 PostFactory；

2、调用 Post::factory()->count(20)->unpublished()->create()；

3、接着调用 Post::factory()->count(10)->published()->create()；

4、最后调用 Post::factory()->count(5)->for(User::factory()->admin())->pendingReview()->create()；

注意：pendingReview() 必须已在 PostFactory 中正确定义，且其返回的 state 数组字段与数据库 schema 完全一致

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~