Laravel数据填充用于在开发和测试阶段快速初始化数据库，通过Seeder类定义初始数据，结合模型工厂、批量插入与事务处理等机制，支持高效、可重复的数据生成，避免重复和性能问题，提升团队协作效率。
Laravel数据填充，简单来说，就是给你的数据库塞点初始数据，尤其是在开发或测试阶段，方便我们快速启动项目或者验证功能。这事儿主要通过编写一些特殊的PHP类来实现，这些类我们叫它们“填充类”或者“Seeder”。你可以在这些类里面定义各种数据，然后用Artisan命令一键导入到数据库里。
要写一个Laravel的填充类，我们通常从生成一个Seeder文件开始。
php artisan make:seeder UserSeeder
这会在
database/seeders
目录下创建一个
UserSeeder.php
文件。打开这个文件，你会看到一个
run()
方法。所有的填充逻辑都写在这里面。
比如，我想填充一些用户数据：
'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
这个主填充类里调用：
call([ UserSeeder::class, ProductSeeder::class, // 假设你还有其他填充类 // CategorySeeder::class, ]); }}
然后，运行填充命令就非常简单了：
php artisan db:seed
如果你只想运行某个特定的Seeder，可以这样：
php artisan db:seed --class=UserSeeder
在开发过程中，我更喜欢用
migrate:fresh --seed
，它会先删除所有表，重新运行迁移，然后执行填充。这样能确保每次都有一个干净的数据库状态，避免各种奇奇怪怪的数据残留问题。
Laravel数据填充在开发初期或测试环境中扮演什么角色？
数据填充这东西，在我看来，是开发和测试阶段的“万金油”。你想啊，一个新项目刚启动，数据库里空空如也，你总不能手动一条条去录入吧？那效率得多低？所以，它最直接的作用就是快速初始化开发环境。比如，一个后台管理系统，你得有个管理员账号才能登录进去看效果，
UserSeeder
就派上用场了。
再往深了说，数据填充对于功能测试和演示简直是神来之笔。开发一个列表页，你总得有几条数据才能看到分页、搜索、排序的效果吧？用
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数据填充？填充类怎样编写使用？的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/146142.html
微信扫一扫 
支付宝扫一扫 
