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\Database\Seeders\Seeder;
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实现测试环境专属数据
