Laravel 中 Factory 定义单条数据生成规则,Seeder 负责批量插入;通过 php artisan make:factory 和 make:seeder 创建,配合 faker 与 bcrypt 实现高效可维护的测试数据填充。

在 Laravel 中,数据填充(Seeding)用于向数据库中插入测试或初始数据,Seeder 负责“执行插入”,Factory 负责“定义如何生成单条数据”。二者配合使用,能高效、可维护地初始化开发/测试环境。
创建 Seeder 和 Factory
先用 Artisan 命令生成:
-
Factory:运行
php artisan make:factory UserFactory --model=User,会在database/factories下生成工厂类,定义用户字段的模拟逻辑(如名字、邮箱、密码)。 -
Seeder:运行
php artisan make:seeder UsersTableSeeder,会在database/seeders下生成种子类,调用工厂批量插入数据。
编写 Factory(以 UserFactory 为例)
打开 UserFactory.php,修改 definition() 方法,返回一个关联数组:
public function definition(): array
{
return [
'name' => $this->faker->name(),
'email' => $this->faker->unique()->safeEmail(),
'password' => bcrypt('password'),
'email_verified_at' => now(),
];
}
注意:$this->faker 是 Laravel 内置的 Faker 实例,支持大量真实感强的假数据;unique() 避免邮箱重复;bcrypt() 加密密码,符合 Laravel 默认用户模型要求。
编写 Seeder 并调用 Factory
在 UsersTableSeeder.php 的 run() 方法中,用 User::factory()->count(50)->create(); 一次性创建 50 个用户。也可以指定字段覆盖:
User::factory()
->count(10)
->state(['email_verified_at' => null])
->create();
如果需要关联数据(比如为每个用户创建一条个人资料),可链式调用 has():
User::factory()
->has(Profile::factory()->count(1))
->count(20)
->create();
运行和管理填充
执行填充前确保数据库已迁移(php artisan migrate)。常用命令有:
-
php artisan db:seed—— 运行默认的DatabaseSeeder -
php artisan db:seed --class=UsersTableSeeder—— 只运行指定 Seeder -
php artisan db:seed --force—— 在生产环境也允许运行(需显式加此参数)
推荐把常用 Seeder 注册到 DatabaseSeeder.php 的 run() 方法中,保持主入口统一:
public function run(): void
{
$this->call([
UsersTableSeeder::class,
PostsTableSeeder::class,
CommentsTableSeeder::class,
]);
}
基本上就这些。Factory 定义“怎么造数据”,Seeder 定义“造多少、何时造、跟谁关联”,配合 Faker 就能快速搭建出贴近真实的测试数据集。









