在 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() 正是用于在集合最前端插入单个元素的标准方式。
✅ 正确做法如下：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
$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);
⚠️ 注意事项：
-
prepend()返回新集合（Laravel 集合默认不可变），因此必须重新赋值给变量（如上例所示），否则原集合不会被修改； - 若需插入多个元素到开头，可链式调用多次
prepend()，或使用merge()配合自定义集合（如collect([$item1, $item2])->merge($original)），但语义上prepend()更清晰、更推荐用于单元素前置； - 不要混淆
push()（尾部追加）与prepend()（头部插入）——二者行为完全相反； - 确保插入的对象类型与集合一致（如本例中均为
FamilyMember实例），避免后续遍历时类型异常。
? 小技巧：若需保持“所有成员”选项始终排第一且支持分页场景，建议不在查询后手动 prepend，而改用数据库视图、UNION 查询或前端逻辑处理；但对于简单列表渲染（如下拉框），prepend() 是简洁可靠的解决方案。
