laravel 8 对模型工厂（model factories）进行了重大革新，从基于全局 $factory 对象的闭包定义，转变为独立的类结构。这一改变提升了工厂的可维护性和可发现性。对于从 laravel 7 或更早版本升级的开发者而言，理解并实施这些重构是必要的。
Laravel 7 工厂模式回顾
在 Laravel 7 及更早版本中，工厂通常定义在一个全局的 database/factories/ 目录下的 PHP 文件中，使用 $factory-youjiankuohaophpcndefine() 方法来为特定模型定义数据生成逻辑。
<?php
/** @var \Illuminate\Database\Eloquent\Factory $factory */
use App\Login;
use App\User;
use App\Tenant;
use Faker\Generator as Faker;
$factory->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 工厂结构
新的工厂类继承自 Illuminate\Database\Eloquent\Factories\Factory，并包含一个 definition() 方法，该方法返回一个数组，定义了模型的默认属性状态。
以下是 User 模型在 Laravel 8 中的工厂示例：
<?php
namespace Database\Factories;
use App\Models\User; // 注意：模型通常位于 App\Models 命名空间
use Illuminate\Database\Eloquent\Factories\Factory;
use Illuminate\Support\Str;
class UserFactory extends Factory
{
/**
* 定义工厂对应的模型。
*
* @var string
*/
protected $model = User::class;
/**
* 定义模型的默认状态。
*
* @return array<string, mixed>
*/
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),
];
}
}关键变化点：
- 命名空间： 工厂类通常位于 Database\Factories 命名空间下。
- 继承： 工厂类必须继承 Illuminate\Database\Eloquent\Factories\Factory。
- $model 属性： 通过 $model 属性明确指定该工厂对应的模型类。
- definition() 方法： 替代了闭包，返回模型的默认属性数组。在 definition() 方法中，可以直接通过 $this->faker 访问 Faker 实例。
关联模型与 HasFactory Trait
为了让 Laravel 能够自动发现并使用模型工厂，需要在对应的 Eloquent 模型中引入 Illuminate\Database\Eloquent\Factories\HasFactory Trait。
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
use HasFactory;
// ... 其他模型定义
}引入 HasFactory Trait 后，就可以通过 User::factory() 方法来创建模型实例，例如 User::factory()->create()。
当一个工厂需要创建关联模型时，可以直接使用 Model::factory() 方法，而不再是旧版的 factory(App\Model::class)。
具体案例分析：LoginFactory 重构
根据上述原则，将 Laravel 7 的 Login 模型工厂重构到 Laravel 8。
Laravel 7 原工厂：
<?php
// ...
$factory->define(Login::class, function (Faker $faker) {
$randomDateTime = $faker->dateTimeBetween('-6 hours', 'now');
return [
'user_id' => factory(App\User::class),
'tenant_id' => factory(App\Tenant::class),
'created_at' => $randomDateTime,
'updated_at' => $randomDateTime,
];
});重构为 Laravel 8 LoginFactory： 创建一个新文件 database/factories/LoginFactory.php：
<?php
namespace Database\Factories;
use App\Models\Login; // 假设 Login 模型位于 App\Models 命名空间
use App\Models\User; // 假设 User 模型位于 App\Models 命名空间
use App\Models\Tenant; // 假设 Tenant 模型位于 App\Models 命名空间
use Illuminate\Database\Eloquent\Factories\Factory;
class LoginFactory extends Factory
{
/**
* 定义工厂对应的模型。
*
* @var string
*/
protected $model = Login::class;
/**
* 定义模型的默认状态。
*
* @return array<string, mixed>
*/
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,
];
}
}模型修改： 同时，确保 App\Models\Login、App\Models\User 和 App\Models\Tenant 模型都引入了 HasFactory Trait：
// App/Models/Login.php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Login extends Model
{
use HasFactory;
// ...
}
// App/Models/User.php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
use HasFactory;
// ...
}
// App/Models/Tenant.php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Tenant extends Model
{
use HasFactory;
// ...
}总结与注意事项
- 命名空间与文件路径： Laravel 8 工厂默认位于 database/factories 目录下，并使用 Database\Factories 命名空间。确保工厂类名与模型名匹配（例如 UserFactory 对应 User 模型）。
- $model 属性： 在工厂类中明确指定 $model 属性是最佳实践，尽管 Laravel 8 也可以通过约定自动发现（如 UserFactory 会尝试匹配 App\Models\User）。
- definition() 方法： 替代了 Laravel 7 的闭包，成为定义模型属性的核心方法。
- HasFactory Trait： 必须在所有需要使用新工厂模式生成数据的模型中引入此 Trait。
- 关联工厂调用： 使用 Model::factory() 替代 factory(Model::class) 来创建关联模型。
- Faker 实例： 在 definition() 方法中，通过 $this->faker 即可访问 Faker 实例，无需通过参数注入。
通过以上步骤，开发者可以顺利地将旧版 Laravel 7 的模型工厂重构至 Laravel 8 的现代化类式工厂，从而享受更清晰、更易于管理的测试数据生成体验。
