在 Laravel 中，向 Eloquent 集合（Collection）的首位添加元素不能使用原生 PHP 的 array_unshift()，而应使用集合内置的 prepend() 方法。

在 laravel 中，向 eloquent 集合（collection）的首位添加元素不能使用原生 php 的 `array_unshift()`，而应使用集合内置的 `prepend()` 方法。

Laravel 的 Illuminate\Database\Eloquent\Collection 是一个功能丰富的对象集合，并非普通数组，因此不支持直接使用面向数组的函数（如 array_unshift()）。当你调用 FamilyMember::all() 时，返回的是一个 Collection 实例，它提供了专为集合设计的链式方法——其中 prepend() 正是用于在集合最前端插入单个元素的标准方式。

✅ 正确做法如下：

$family_members = FamilyMember::all();

$tmp_all_members = new FamilyMember();
$tmp_all_members->id = 'all_family_member';
$tmp_all_members->name = 'All Family Member';

// 使用 prepend() 将元素插入到集合开头（索引 0）
$family_members = $family_members->prepend($tmp_all_members);

⚠️ 注意事项：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

• prepend() 返回新集合（Laravel 集合默认不可变），因此必须重新赋值给变量（如上例所示），否则原集合不会被修改；
• 若需插入多个元素到开头，可链式调用多次 prepend()，或使用 merge() 配合自定义集合（如 collect([$item1, $item2])->merge($original)），但语义上 prepend() 更清晰、更推荐用于单元素前置；
• 不要混淆 push()（尾部追加）与 prepend()（头部插入）——二者行为完全相反；
• 确保插入的对象类型与集合一致（如本例中均为 FamilyMember 实例），避免后续遍历时类型异常。

? 小技巧：若需保持“所有成员”选项始终排第一且支持分页场景，建议不在查询后手动 prepend，而改用数据库视图、UNION 查询或前端逻辑处理；但对于简单列表渲染（如下拉框），prepend() 是简洁可靠的解决方案。