在 laravel 应用开发中，处理多对多（many-to-many）关系是常见的需求。例如，一个“人”（person）可以拥有多个“技能”（skill），而一个“技能”也可以被多个人拥有。当我们需要查询所有人的信息，并且希望每个人的技能以一个简单的名称数组形式呈现时，就需要采用特定的 eloquent 查询和数据处理技巧。
1. 理解多对多关系模型设置
首先，确保你的 Eloquent 模型已正确配置多对多关系。假设我们有 Person 和 Skill 两个模型，以及一个中间表（例如 person_skill）。
数据库表结构示例：
- person_table: id, name_of_person
- skills_table: id, name_of_skill
- person_skill (中间表): person_id, skill_id
Eloquent 模型定义示例：
在 Person 模型中定义与 Skill 模型的多对多关系：
// app/Models/Person.php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
class Person extends Model
{
protected $table = 'person_table'; // 确保表名正确
public function skills(): BelongsToMany
{
return $this->belongsToMany(Skill::class, 'person_skill', 'person_id', 'skill_id');
}
}在 Skill 模型中定义与 Person 模型的多对多关系（可选，但推荐）：
// app/Models/Skill.php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
class Skill extends Model
{
protected $table = 'skills_table'; // 确保表名正确
public function persons(): BelongsToMany
{
return $this->belongsToMany(Person::class, 'person_skill', 'skill_id', 'person_id');
}
}2. 预加载关联数据以避免 N+1 问题
在查询主表数据时，如果直接通过循环访问关联数据，会导致臭名昭著的 N+1 查询问题，严重影响性能。为了避免这种情况，我们应该使用 Eloquent 的 with() 方法进行关联数据预加载（Eager Loading）。
use App\Models\Person;
// 获取所有 Person 及其关联的 Skill 数据
$persons = Person::with('skills')->get();
// 此时，$persons 是一个 Person 模型的集合，每个 Person 模型都已加载了其 skills 关系。
// 例如，如果你访问 $persons->first()->skills，它将是一个包含 Skill 模型的 Collection。3. 提取并格式化特定列数据
Person::with('skills')->get() 返回的 skills 关系是一个 Collection，其中包含完整的 Skill 模型对象（包括 id、name_of_skill 等所有字段）。而我们的目标是只获取 name_of_skill 字段并将其组织成一个字符串数组。
Laravel Collection 提供了 pluck() 方法，可以方便地从集合中提取指定键的值。结合 map() 方法，我们可以遍历 Person 集合，对每个 Person 对象的 skills 关系进行转换。
use App\Models\Person;
$persons = Person::with('skills')->get();
$formattedPersons = $persons->map(function (Person $person) {
return [
'id' => $person->id,
'name' => $person->name_of_person,
'skills' => $person->skills->pluck('name_of_skill')->toArray(), // 使用 pluck 提取技能名称，并转换为数组
];
});
// $formattedPersons 现在是一个包含所需格式数据的集合
/* 示例输出 (通过 $formattedPersons->toArray() 查看):
[
{
"id": 1,
"name": "harat",
"skills": [
"php",
"laravel",
"reactjs",
"nodejs"
]
},
// ... 更多 Person 数据
]
*/在上述代码中：
- $persons->map(...) 遍历 Person 模型的集合。
- 对于每个 Person 模型，我们构建一个新的关联数组。
- $person->skills 访问预加载的技能集合。
- $person->skills->pluck('name_of_skill') 从技能集合中提取所有 name_of_skill 字段的值，返回一个新的 Collection。
- .toArray() 将这个 Collection 转换为一个纯 PHP 数组，符合我们期望的输出格式。
4. 利用 Laravel API Resources 优化输出
对于更复杂的 API 响应或需要统一数据输出格式的场景，Laravel 的 API Resources 是一个更优雅、更强大的解决方案。它允许你将模型的转换逻辑封装起来，提供一个清晰且可复用的数据层。
创建 Resource：
php artisan make:resource PersonResource php artisan make:resource SkillResource
定义 SkillResource (如果需要，这里我们直接在 PersonResource 中处理):
// app/Http/Resources/SkillResource.php
// 如果只需要名称，可以考虑不在 SkillResource 中做太多处理，或直接在 PersonResource 中 pluck
// 但如果 Skill 有其他字段需要展示，则 SkillResource 会很有用。
/*
use Illuminate\Http\Resources\Json\JsonResource;
class SkillResource extends JsonResource
{
public function toArray($request)
{
return [
'id' => $this->id,
'name' => $this->name_of_skill,
// ... 其他技能相关字段
];
}
}
*/定义 PersonResource：
// app/Http/Resources/PersonResource.php
namespace App\Http\Resources;
use Illuminate\Http\Resources\Json\JsonResource;
class PersonResource extends JsonResource
{
/**
* 将资源转换为数组。
*
* @param \Illuminate\Http\Request $request
* @return array
*/
public function toArray($request)
{
return [
'id' => $this->id,
'name' => $this->name_of_person,
'skills' => $this->whenLoaded('skills', function () {
return $this->skills->pluck('name_of_skill'); // 直接 pluck 名称
// 如果 SkillResource 定义了，也可以这样：
// return SkillResource::collection($this->skills->pluck('name_of_skill')); // 假设 SkillResource 只需要名称
}),
];
}
}在控制器中使用 Resource：
// app/Http/Controllers/PersonController.php
namespace App\Http\Controllers;
use App\Models\Person;
use App\Http\Resources\PersonResource;
use Illuminate\Http\Request;
class PersonController extends Controller
{
public function index()
{
$persons = Person::with('skills')->get();
// 使用 PersonResource::collection() 处理集合
return PersonResource::collection($persons);
}
public function show(Person $person)
{
// 对于单个 Person，确保加载 skills
$person->load('skills');
return new PersonResource($person);
}
}$this->whenLoaded('skills', ...) 是一个非常有用的辅助函数，它确保只有在 skills 关系已经被预加载时，才执行闭包内的逻辑。这有助于避免不必要的查询，并使资源更加健壮。
5. 注意事项与最佳实践
- 始终使用 with() 进行预加载： 这是避免 N+1 查询问题的关键，尤其是在处理集合时。
- 选择合适的工具： 对于简单的格式化需求，map() 和 pluck() 组合非常高效。对于复杂的 API 响应、条件字段、嵌套资源等，API Resources 是更推荐的选择，它能提供更好的结构和可维护性。
- 性能优化： 如果 skills 集合非常庞大，pluck() 操作可能会消耗一定的内存。在极端情况下，可以考虑在数据库层面进行更精细的查询优化，但对于大多数场景，Eloquent 的预加载和 pluck 已经足够高效。
- 清晰的命名： 保持模型、关系和数据库字段命名的一致性和清晰性，可以大大提高代码的可读性和可维护性。
总结
通过本教程，我们学习了如何利用 Laravel Eloquent 的 with() 方法进行多对多关系的预加载，并通过 map() 和 pluck() 方法将关联模型的特定列数据提取并格式化为数组。此外，我们还探讨了使用 Laravel API Resources 这一更专业、更灵活的方案来统一和优化 API 响应的数据结构。掌握这些技巧将帮助你更高效、更优雅地处理 Laravel 中的复杂数据关系，构建高性能的 Web 应用和 API。
