Laravel API ResourceCollection如何使用数组而非Eloquent模型传参？

嘿，我完全get到你的需求了——通过适配器返回数组而非Eloquent模型，既保持API Resource/Collection的规范输出，又实现控制器和底层模型的彻底解耦，方便后续替换适配器对吧？这思路相当稳妥，下面给你一步步拆解具体实现：

首先把适配器原本返回Eloquent模型/集合的逻辑，改成返回序列化后的数组。比如：

原适配器（返回Eloquent集合） #

public function getUsers(): Collection
{
    return User::all();
}

修改后（返回数组） #

public function getUsers(): array
{
    return User::all()->toArray();
}

如果是单条记录的查询：

public function getUser(int $id): array
{
    return User::findOrFail($id)->toArray();
}

提示：如果你的模型有自定义toArray()逻辑（比如隐藏敏感字段、追加自定义属性），序列化后的数组会自动继承这些处理，完全符合API输出的需求。

默认的JsonResource虽然是为Eloquent模型设计的，但它天生支持数组输入——你甚至不需要修改资源类的核心逻辑！

比如你的UserResource：

class UserResource extends JsonResource
{
    public function toArray($request)
    {
        // 不管传入的是模型还是数组，都可以用$this->属性名访问
        return [
            'id' => $this->id,
            'name' => $this->name,
            'email' => $this->email,
            'created_at' => $this->created_at,
        ];
    }
}

当你传入数组时，JsonResource会自动把数组转换成StdClass对象，所以你依然可以用$this->xxx的方式访问属性，完全不用改动资源的序列化逻辑。

现在控制器直接拿适配器返回的数组，传给API Resource/Collection即可：

单条记录场景 #

public function show(UserAdapter $adapter, int $id)
{
    $userArray = $adapter->getUser($id);
    return new UserResource($userArray);
}

集合场景 #

public function index(UserAdapter $adapter)
{
    $usersArray = $adapter->getUsers();
    return UserResource::collection($usersArray);
}

提示：Resource::collection()接受数组参数时，会自动遍历每个元素并实例化对应的Resource类，行为和传入Eloquent集合完全一致。

为了让后续替换适配器的成本降到最低，建议给适配器定义一个统一接口：

interface UserAdapterInterface
{
    public function getUsers(): array;
    public function getUser(int $id): array;
}

然后让你的Eloquent适配器实现这个接口：

class EloquentUserAdapter implements UserAdapterInterface
{
    // 实现接口方法，返回数组
}

这样后续如果要切换数据源（比如Redis、外部API），只需要写个新的适配器实现该接口，控制器完全不用修改——彻底实现了解耦。

最后测试一下：适配器返回数组后，API输出的JSON格式和原来返回模型时完全一致。比如原来的响应：

{
    "data": {
        "id": 1,
        "name": "John Doe",
        "email": "john@example.com",
        "created_at": "2024-01-01T00:00:00Z"
    }
}

用数组传入后，输出的JSON完全相同，前端完全感知不到底层数据源的变化。

内容的提问来源于stack exchange，提问作者InTooDeep