本文旨在讲解如何在 Laravel 框架中高效地保存多个关联模型。通过示例代码，我们将演示如何利用 `createMany` 和 `insert` 方法，将公司及其关联的多个联系人信息一次性保存到数据库中，提升数据处理效率。同时，还将讨论数据验证和安全方面的注意事项，确保数据的完整性和安全性。
使用 createMany 方法保存关联模型
Laravel 提供了 createMany 方法，可以方便地创建并关联多个模型。这种方法特别适用于一对多关系，例如一个公司对应多个联系人的场景。
假设我们有两个模型：Company（公司）和 Contact（联系人），并且 Company 模型已经定义了与 Contact 模型的一对多关系。
// Company 模型 (app/Models/Company.php)
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
class Company extends Model
{
use HasFactory;
protected $fillable = ['name'];
public function contacts(): HasMany
{
return $this->hasMany(Contact::class);
}
}
// Contact 模型 (app/Models/Contact.php)
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Contact extends Model
{
use HasFactory;
protected $fillable = ['name', 'phone', 'company_id'];
}以下是如何使用 createMany 方法保存公司及其联系人的示例代码：
use App\Models\Company;
use Illuminate\Http\Request;
public function store(Request $request)
{
// 假设请求数据如下：
// {
// "name": "Company Name1",
// "contacts": [
// {
// "name":"John Doe",
// "phone":"123123"
// },
// {
// "name":"John Doe 2",
// "phone":"123123"
// }
// ]
// }
// 1. 创建公司
$company = Company::create($request->only('name'));
// 2. 创建联系人并关联到公司
$company->contacts()->createMany($request->input('contacts'));
return response()->json(['message' => 'Company and contacts created successfully!']);
}代码解释：
$company = Company::create($request->only('name'));：这行代码使用 create 方法创建一个新的 Company 实例，并将请求中的 name 字段的值赋给它。$request->only('name') 确保只有 name 字段被用于创建公司，从而防止意外的数据填充。
$company->contacts()->createMany($request->input('contacts'));：这行代码使用 createMany 方法创建多个 Contact 实例，并将它们关联到刚刚创建的 Company 实例。$request->input('contacts') 获取请求中的 contacts 数组，其中包含了要创建的联系人的数据。createMany 方法会自动设置 contact 表中的 company_id 外键，将其设置为新创建的 company 的 ID。
使用 insert 方法批量插入数据
另一种批量插入数据的方法是使用 insert 方法。这种方法更加高效，因为它直接操作数据库，避免了模型事件的触发。但是，使用 insert 方法需要手动设置外键。
use App\Models\Company;
use App\Models\Contact;
use Illuminate\Http\Request;
public function store(Request $request)
{
// 1. 创建公司
$company = new Company;
$company->name = $request->input('name');
$company->save();
// 2. 准备联系人数据
$contactsData = [];
foreach ($request->input('contacts') as $contact) {
$contact['company_id'] = $company->id; // 设置外键
$contactsData[] = $contact;
}
// 3. 批量插入联系人
Contact::insert($contactsData);
return response()->json(['message' => 'Company and contacts created successfully!']);
}代码解释：
- 首先，创建一个新的 Company 实例，并从请求中获取公司名称。
- 然后，遍历请求中的 contacts 数组，为每个联系人数据添加 company_id 字段，将其设置为新创建的 company 的 ID。
- 最后，使用 Contact::insert($contactsData) 将所有联系人数据批量插入到数据库中。
数据验证与安全
在保存数据之前，务必进行数据验证，以确保数据的完整性和安全性。Laravel 提供了强大的验证功能，可以轻松地验证请求数据。
use Illuminate\Support\Facades\Validator;
use Illuminate\Http\Request;
public function store(Request $request)
{
$validator = Validator::make($request->all(), [
'name' => 'required|string|max:255',
'contacts' => 'required|array',
'contacts.*.name' => 'required|string|max:255',
'contacts.*.phone' => 'required|string|max:20',
]);
if ($validator->fails()) {
return response()->json(['errors' => $validator->errors()], 422);
}
// ... 保存数据的代码 ...
}代码解释：
- Validator::make($request->all(), [...])：创建一个新的验证器实例，并传入请求中的所有数据以及验证规则。
- 验证规则：
- name：必须存在，是字符串，最大长度为 255。
- contacts：必须存在，是数组。
- contacts.*.name：contacts 数组中的每个元素的 name 字段必须存在，是字符串，最大长度为 255。
- contacts.*.phone：contacts 数组中的每个元素的 phone 字段必须存在，是字符串，最大长度为 20。
- if ($validator->fails()) { ... }：如果验证失败，则返回包含错误信息的 JSON 响应，状态码为 422（Unprocessable Entity）。
此外，为了防止 SQL 注入等安全问题，建议使用 Laravel 的 Eloquent ORM 或查询构建器来操作数据库，而不是直接拼接 SQL 语句。
总结
本文介绍了在 Laravel 中保存多个关联模型的两种方法：createMany 和 insert。createMany 方法简单易用，适用于简单的关联关系；insert 方法更加高效，适用于需要批量插入大量数据的场景。无论使用哪种方法，都应该注意数据验证和安全，以确保数据的完整性和安全性。选择哪种方法取决于具体的业务需求和性能要求。
