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() 或重新赋值）。

✅ 正确示例代码如下：

$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);

⚠️ 注意事项：

Laravel Cloud

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

下载

• 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 的响应式数据流与链式调用风格。