Laravel数据填充？填充类怎样编写使用？

31次阅读

Laravel数据填充用于在开发和测试阶段快速初始化数据库，通过Seeder类定义初始数据，结合模型工厂、批量插入与事务处理等机制，支持高效、可重复的数据生成，避免重复和性能问题，提升团队协作效率。

Laravel数据填充，简单来说，就是给你的数据库塞点初始数据，尤其是在开发或测试阶段，方便我们快速启动项目或者验证功能。这事儿主要通过编写一些特殊的PHP类来实现，这些类我们叫它们“填充类”或者“Seeder”。你可以在这些类里面定义各种数据，然后用Artisan命令一键导入到数据库里。

要写一个Laravel的填充类，我们通常从生成一个Seeder文件开始。

php artisan make:seeder UserSeeder

这会在

database/seeders

目录下创建一个

UserSeeder.php

文件。打开这个文件，你会看到一个

run()

方法。所有的填充逻辑都写在这里面。

比如，我想填充一些用户数据：

<?php  namespace DatabaseSeeders;  use AppModelsUser; // 假设你有User模型 use IlluminateDatabaseSeeder; use IlluminateSupportFacadesHash; // 可能需要哈希密码  class UserSeeder extends Seeder {     /**      * Run the database seeds.      */     public function run(): void     {         // 方式一：直接创建         User::create([             'name' => 'Admin User',             'email' => 'admin@example.com',             'password' => Hash::make('password'),         ]);          // 方式二：使用模型工厂（推荐，特别是复杂数据）         // 确保你已经创建了UserFactory         User::factory()->count(10)->create();          // 方式三：使用firstOrCreate避免重复         User::firstOrCreate(             ['email' => 'test@example.com'],             [                 'name' => 'Test User',                 'password' => Hash::make('password'),             ]         );     } }

这里我展示了几种常见的数据填充方式：直接

create

，用

factory

批量生成，还有

firstOrCreate

来避免重复。个人觉得，

factory

是Laravel数据填充的精髓，它让你可以用非常声明式的方式定义模型数据的结构和关系，填充起来简直不要太爽。

当你写好了多个Seeder，通常会把它们集中在

DatabaseSeeder.php

这个主填充类里调用：

<?php  namespace DatabaseSeeders;  use IlluminateDatabaseSeeder;  class DatabaseSeeder extends Seeder {     /**      * Seed the application's database.      */     public function run(): void     {         $this->call([             UserSeeder::class,             ProductSeeder::class, // 假设你还有其他填充类             // CategorySeeder::class,         ]);     } }

然后，运行填充命令就非常简单了：

php artisan db:seed

如果你只想运行某个特定的Seeder，可以这样：

php artisan db:seed --class=UserSeeder

在开发过程中，我更喜欢用

migrate:fresh --seed

，它会先删除所有表，重新运行迁移，然后执行填充。这样能确保每次都有一个干净的数据库状态，避免各种奇奇怪怪的数据残留问题。

Laravel数据填充在开发初期或测试环境中扮演什么角色？

数据填充这东西，在我看来，是开发和测试阶段的“万金油”。你想啊，一个新项目刚启动，数据库里空空如也，你总不能手动一条条去录入吧？那效率得多低？所以，它最直接的作用就是快速初始化开发环境。比如，一个后台管理系统，你得有个管理员账号才能登录进去看效果，

UserSeeder

就派上用场了。

Vmake AI

全能电商创意工作室：生成AI服装虚拟模特

105

查看详情

再往深了说，数据填充对于功能测试和演示简直是神来之笔。开发一个列表页，你总得有几条数据才能看到分页、搜索、排序的效果吧？用

factory

几行代码就能生成成千上万条模拟数据，简直不要太方便。我以前做项目，经常会准备一套“演示数据”，客户来看的时候，直接

db:seed

一下，一个活生生的系统就摆在面前了，比光秃秃的界面强太多了。

还有，它能帮助我们模拟各种边界条件和复杂场景。比如，一个订单系统，你需要测试不同状态的订单（待支付、已支付、已发货），用填充类就能精准地创建这些特定状态的数据，而不用去真实地走一遍业务流程。这在自动化测试，尤其是集成测试和E2E测试中，提供了非常稳定的数据基础。没有它，测试数据的准备会变得异常繁琐和不可控。

如何避免Laravel数据填充时出现重复数据或性能问题？

这确实是数据填充过程中经常会遇到的“坑”。不注意的话，你可能每次运行

db:seed

都会塞进去一堆重复数据，或者数据量一大，直接把数据库搞崩溃。

避免重复数据，最常见也最直接的方法就是在使用

firstOrCreate

或

updateOrCreate

。这俩方法在填充特定、唯一性要求高的数据（比如管理员账号、特定配置项）时特别好用。它们会先尝试查找，如果找到了就返回现有数据，找不到才创建。

// 示例：确保某个配置项只存在一条 Setting::firstOrCreate(     ['key' => 'app_name'],     ['value' => 'My Awesome App'] );

对于一些需要清空再填充的场景，比如每次测试前都希望数据库是全新的，那么在

DatabaseSeeder

的

run()

方法开头加上

DB::table('your_table')->truncate();

或者

Model::truncate();

是个不错的选择。不过，

truncate()

会重置自增ID，如果需要保留自增ID的连续性，可能需要考虑

delete()

所有数据。当然，前面提到的

php artisan migrate:fresh --seed

是更彻底的方案，它直接重建数据库。

关于性能问题，这通常发生在你要填充大量数据的时候。

禁用事件和模型观察者：在填充大量数据时，模型的

created

、

updated

等事件，或者模型观察者可能会被触发，这会显著降低性能。你可以在填充前临时禁用它们：

// 禁用所有模型事件 AppModelsYourModel::withoutEvents(function () {     AppModelsYourModel::factory()->count(10000)->create(); }); // 或者更细粒度地禁用特定事件 // AppModelsYourModel::unsetEventDispatcher(); // ... 填充 ... // AppModelsYourModel::setEventDispatcher(app('events'));

批量插入：使用
```
insert()
```
方法而不是循环调用
```
create()
```
。
```
create()
```
每次都会触发模型事件、填充
```
created_at
```
/
```
updated_at
```
等，并执行一次SQL插入。而
```
insert()
```
可以直接插入多条记录，效率高很多。模型工厂配合
```
make()
```
和
```
insert()
```
可以实现这一点：
```
$data = User::factory()->count(50000)->make()->toArray(); User::insert($data);
```
事务处理：将整个填充过程包裹在一个数据库事务中。这样即使中间出现错误，也能回滚，避免数据不一致。而且，在某些数据库系统下，事务内的批量操作性能会更好。
```
DB::transaction(function () {     User::factory()->count(10000)->create();     Product::factory()->count(20000)->create(); });
```
关闭外键约束：在填充有外键关联的大量数据时，临时关闭外键约束可以提升性能，并在填充完成后再开启。但要小心使用，确保数据完整性。
```
Schema::disableForeignKeyConstraints(); // ... 你的填充逻辑 ... Schema::enableForeignKeyConstraints();
```
这些方法结合起来，能大大优化大型数据填充的效率，避免你坐在电脑前等半天，或者干脆报错。

在团队协作中，Laravel数据填充的最佳实践有哪些？

在团队协作的环境下，数据填充如果管理不好，很容易变成一个“坑”，导致大家的开发环境不一致，或者本地数据混乱。

我觉得最重要的几点：

模块化和职责分离：不要把所有数据填充逻辑都塞到一个
```
DatabaseSeeder
```
里。应该为每个模型或每个相关功能模块创建独立的Seeder类。比如
```
UserSeeder
```
、
```
ProductSeeder
```
、
```
CategorySeeder
```
。这样，当某个功能的数据结构发生变化时，只需要修改对应的Seeder，不会影响到其他部分。这就像代码一样，高内聚低耦合，修改起来方便，也便于团队成员分工。
清晰的命名和注释： Seeder类的命名要清晰明了，一眼就知道它是干嘛的。在
```
run()
```
方法里，对于一些复杂的填充逻辑，或者需要特殊说明的地方，加上适当的注释。这对于新加入的团队成员或者几个月后自己回头看代码，都能省去不少麻烦。
版本控制和同步：所有的Seeder文件都应该纳入版本控制（Git）。当团队成员拉取最新代码时，如果涉及到新的Seeder文件或者现有Seeder的修改，他们应该知道如何更新本地数据库。通常的做法是，在项目的
```
README.md
```
或者一个专门的开发指南里，明确说明运行
```
php artisan migrate:fresh --seed
```
或者
```
php artisan db:seed
```
的必要性，以及何时需要这样做。

环境敏感性填充：有时候，你可能需要在不同的环境（开发、测试、生产）下填充不同的数据。例如，开发环境需要大量模拟数据，而生产环境可能只需要一些基础配置数据。Laravel并没有直接提供“环境填充”的机制，但你可以通过在Seeder中判断

App::environment()

来实现：

 use IlluminateSupportFacadesApp;  class UserSeeder extends Seeder {     public function run(): void     {         if (App::environment('local', 'testing')) {             User::factory()->count(50)->create();         } else if (App::environment('production')) {             // 生产环境可能只创建管理员账号             User::firstOrCreate([                 'email' => 'admin@yourdomain.com',

以上就是Laravel数据填充？填充类怎样编写使用？的详细内容，更多请关注laravel php word git go cad app 电脑 ai 开发环境 php laravel sql 循环数据结构堆 delete 事件 table git database 数据库自动化