本教程详细介绍了将 Laravel 7 的旧式工厂重构至 Laravel 8 全新类式工厂的方法。文章涵盖了两种迁移策略：快速引入兼容包以支持旧工厂，或彻底改写为 Laravel 8 的类式工厂结构。通过具体代码示例，指导开发者如何定义工厂类、使用 HasFactory Trait，并处理模型关联，确保数据填充的现代化与高效性。
laravel 8 对模型工厂（model factories）进行了重大革新，从基于全局 $factory 对象的闭包定义，转变为独立的类结构。这一改变提升了工厂的可维护性和可发现性。对于从 laravel 7 或更早版本升级的开发者而言，理解并实施这些重构是必要的。
Laravel 7 工厂模式回顾
在 Laravel 7 及更早版本中，工厂通常定义在一个全局的 database/factories/ 目录下的 PHP 文件中，使用 $factory->define() 方法来为特定模型定义数据生成逻辑。
define(Login::class, function (Faker $faker) { $randomDateTime = $faker->dateTimeBetween('-6 hours', 'now'); return [ 'user_id' => factory(User::class), // 旧版关联工厂调用 'tenant_id' => factory(Tenant::class), // 旧版关联工厂调用 'created_at' => $randomDateTime, 'updated_at' => $randomDateTime, ];});
这种方式虽然有效，但在大型项目中，工厂定义可能会变得分散且难以管理。
迁移策略一：使用旧版工厂兼容包
如果项目时间紧迫，或者需要逐步迁移，Laravel 提供了一个兼容包 laravel/legacy-factories，允许在 Laravel 8 环境下继续使用 Laravel 7 的工厂定义方式。
安装该兼容包：
composer require laravel/legacy-factories
安装后，Laravel 8 将能够识别并使用旧版 $factory->define 风格的工厂文件，无需立即进行代码重构。这是一种权宜之计，推荐最终还是迁移到 Laravel 8 的新工厂模式。
迁移策略二：彻底重构为 Laravel 8 类式工厂
Laravel 8 引入了全新的类式工厂模式，每个模型工厂都作为一个独立的 PHP 类存在，通常位于 database/factories 目录下。
理解 Laravel 8 工厂结构
新的工厂类继承自 IlluminateDatabaseEloquentFactoriesFactory，并包含一个 definition() 方法，该方法返回一个数组，定义了模型的默认属性状态。
以下是 User 模型在 Laravel 8 中的工厂示例：
<?phpnamespace DatabaseFactories;use AppModelsUser; // 注意：模型通常位于 AppModels 命名空间use IlluminateDatabaseEloquentFactoriesFactory;use IlluminateSupportStr;class UserFactory extends Factory{ /** * 定义工厂对应的模型。 * * @var string */ protected $model = User::class; /** * 定义模型的默认状态。 * * @return array */ public function definition(): array { return [ 'name' => $this->faker->name(), 'email' => $this->faker->unique()->safeEmail(), 'email_verified_at' => now(), 'password' => '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi', // 默认密码 'remember_token' => Str::random(10), ]; }}
关键变化点：
命名空间： 工厂类通常位于 DatabaseFactories 命名空间下。继承： 工厂类必须继承 IlluminateDatabaseEloquentFactoriesFactory。$model 属性： 通过 $model 属性明确指定该工厂对应的模型类。definition() 方法： 替代了闭包，返回模型的默认属性数组。在 definition() 方法中，可以直接通过 $this->faker 访问 Faker 实例。
关联模型与 HasFactory Trait
为了让 Laravel 能够自动发现并使用模型工厂，需要在对应的 Eloquent 模型中引入 IlluminateDatabaseEloquentFactoriesHasFactory Trait。
<?phpnamespace AppModels;use IlluminateDatabaseEloquentFactoriesHasFactory;use IlluminateDatabaseEloquentModel;class User extends Model{ use HasFactory; // ... 其他模型定义}
引入 HasFactory Trait 后，就可以通过 User::factory() 方法来创建模型实例，例如 User::factory()->create()。
当一个工厂需要创建关联模型时，可以直接使用 Model::factory() 方法，而不再是旧版的 factory(AppModel::class)。
具体案例分析：LoginFactory 重构
根据上述原则，将 Laravel 7 的 Login 模型工厂重构到 Laravel 8。
Laravel 7 原工厂：
define(Login::class, function (Faker $faker) { $randomDateTime = $faker->dateTimeBetween('-6 hours', 'now'); return [ 'user_id' => factory(AppUser::class), 'tenant_id' => factory(AppTenant::class), 'created_at' => $randomDateTime, 'updated_at' => $randomDateTime, ];});
重构为 Laravel 8 LoginFactory：创建一个新文件 database/factories/LoginFactory.php：
<?phpnamespace DatabaseFactories;use AppModelsLogin; // 假设 Login 模型位于 AppModels 命名空间use AppModelsUser; // 假设 User 模型位于 AppModels 命名空间use AppModelsTenant; // 假设 Tenant 模型位于 AppModels 命名空间use IlluminateDatabaseEloquentFactoriesFactory;class LoginFactory extends Factory{ /** * 定义工厂对应的模型。 * * @var string */ protected $model = Login::class; /** * 定义模型的默认状态。 * * @return array */ public function definition(): array { $randomDateTime = $this->faker->dateTimeBetween('-6 hours', 'now'); return [ 'user_id' => User::factory(), // 使用新版关联工厂调用 'tenant_id' => Tenant::factory(), // 使用新版关联工厂调用 'created_at' => $randomDateTime, 'updated_at' => $randomDateTime, ]; }}
模型修改：同时，确保 AppModelsLogin、AppModelsUser 和 AppModelsTenant 模型都引入了 HasFactory Trait：
// App/Models/Login.phpnamespace AppModels;use IlluminateDatabaseEloquentFactoriesHasFactory;use IlluminateDatabaseEloquentModel;class Login extends Model{ use HasFactory; // ...}// App/Models/User.phpnamespace AppModels;use IlluminateDatabaseEloquentFactoriesHasFactory;use IlluminateDatabaseEloquentModel;class User extends Model{ use HasFactory; // ...}// App/Models/Tenant.phpnamespace AppModels;use IlluminateDatabaseEloquentFactoriesHasFactory;use IlluminateDatabaseEloquentModel;class Tenant extends Model{ use HasFactory; // ...}
总结与注意事项
命名空间与文件路径： Laravel 8 工厂默认位于 database/factories 目录下，并使用 DatabaseFactories 命名空间。确保工厂类名与模型名匹配（例如 UserFactory 对应 User 模型）。$model 属性： 在工厂类中明确指定 $model 属性是最佳实践，尽管 Laravel 8 也可以通过约定自动发现（如 UserFactory 会尝试匹配 AppModelsUser）。definition() 方法： 替代了 Laravel 7 的闭包，成为定义模型属性的核心方法。HasFactory Trait： 必须在所有需要使用新工厂模式生成数据的模型中引入此 Trait。关联工厂调用： 使用 Model::factory() 替代 factory(Model::class) 来创建关联模型。Faker 实例： 在 definition() 方法中，通过 $this->faker 即可访问 Faker 实例，无需通过参数注入。
通过以上步骤，开发者可以顺利地将旧版 Laravel 7 的模型工厂重构至 Laravel 8 的现代化类式工厂，从而享受更清晰、更易于管理的测试数据生成体验。
以上就是深入理解 Laravel 8 全新工厂模式及迁移指南的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1271921.html
微信扫一扫 
支付宝扫一扫 
