Laravel 的 Eloquent Collection 提供了 prepend() 方法，可直接在集合首部添加新元素，无需转换为数组，避免 array_unshift() 因类型不匹配导致的错误。
laravel 的 eloquent collection 提供了 `prepend()` 方法，可直接在集合首部添加新元素，无需转换为数组，避免 `array_unshift()` 因类型不匹配导致的错误。
在 Laravel 开发中，当我们从数据库获取一组模型（如 FamilyMember::all()），返回的是一个 Illuminate\Database\Eloquent\Collection 实例，而非原生 PHP 数组。因此，像 array_unshift() 这类仅接受数组的函数会抛出类型错误：
array_unshift(): Argument #1 ($array) must be of type array, Illuminate\Database\Eloquent\Collection given
正确做法是使用 Collection 原生支持的链式方法 —— prepend()。它将指定元素插入到集合最前端，并返回一个新的（或原地修改后的）集合实例（Laravel 9+ 中 prepend() 默认返回新集合，原集合不变；若需原地修改，可配合 tap() 或重新赋值）。
✅ 正确示例代码如下：
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() 插入到集合开头 $family_members = $family_members->prepend($tmp_all_members);
⚠️ 注意事项：
-
prepend()返回新集合，不会修改原始$family_members变量（Collection 在 Laravel 中默认不可变）；务必重新赋值以保留变更。 - 若需插入多个元素到开头，可连续调用
prepend()，或使用merge()配合collect([$item1, $item2])，但语义上prepend()更直观、更推荐用于单元素前置。 - 不要误用
push()（尾部追加）或unshift()（该方法不存在于 Collection 中——这是常见混淆点）。
? 小技巧：你也可以用 prepend() 添加带键的元素（如用于下拉选项中的占位项）：
$family_members = $family_members->prepend(['id' => '', 'name' => '-- 请选择家庭成员 --'], 'placeholder');
总结：面对 Eloquent Collection，优先使用其内置集合方法（如 prepend、push、map、filter 等），而非尝试将其降级为数组操作——这不仅更安全、更语义化，也完全兼容 Laravel 的响应式数据流与链式调用风格。
