hyperf 的数据库种子用于插入初始或测试数据,风格类似 laravel 但命令和目录结构不同;通过 db::table() 或原生查询操作,不依赖 eloquent 工厂;使用 gen:seeder 命令生成 seeder 类,run() 方法编写逻辑;支持批量插入、辅助函数及外键顺序控制;执行用 db:seed 命令,可指定类或路径,并可与 migrate 联动。

Hyperf 的数据库种子(Seeder)用于向数据库插入初始或测试数据,和 Laravel 风格高度一致,但命令和目录结构略有差异。它不依赖 Eloquent 模型工厂(默认未启用),主要通过 DB::table() 或原生查询构造器操作,适合轻量、明确的数据初始化场景。
生成 Seeder 文件
使用内置命令创建填充类:
-
php bin/hyperf.php gen:seeder UserSeeder—— 在seeders/目录下生成UserSeeder.php - 文件默认继承
Hyperf\Database\Seeders\Seeder,核心逻辑写在run()方法中 - 若需自定义路径,可加
--path=参数,例如:php bin/hyperf.php gen:seeder --path=app/Seeders/RoleSeeder
编写填充逻辑
在 run() 方法中插入数据,推荐使用 DB::table() 批量写入:
- 基础示例(插入两条用户):
use Hyperf\DbConnection\Db;
class UserSeeder extends Seeder
{
public function run()
{
Db::table('users')->insert([
['name' => '张三', 'email' => 'zhang@example.com'],
['name' => '李四', 'email' => 'li@example.com'],
]);
}
}
- 支持
now()、bcrypt()等 Laravel 兼容辅助函数(需确保已加载对应 Facade 或 Helper) - 如需处理外键依赖(如先插
roles再插users),需手动控制执行顺序或拆分多个 Seeder
运行 Seeder 命令
Hyperf 没有默认的 DatabaseSeeder 主入口,因此运行方式更直接:
- 执行全部 Seeder(按文件名字母序):
php bin/hyperf.php db:seed - 执行指定 Seeder(推荐):
php bin/hyperf.php db:seed --class=UserSeeder - 按绝对路径执行(适用于自定义位置):
php bin/hyperf.php db:seed --path=seeders/UserSeeder.php - 配合迁移一起运行(先 migrate,再 seed):
php bin/hyperf.php migrate --seed
与迁移联动的小技巧
Seeder 常和迁移搭配使用,构建完整初始化流程:
- 迁移完成后再填充,避免表不存在报错;
migrate --seed会自动触发db:seed - 开发环境可一键重置:
php bin/hyperf.php migrate:fresh --seed(需确认该命令已注册,或自行封装) - 多环境填充:用
--env=testing控制配置,再结合--seed实现测试环境专属数据










