Laravel Eloquent的API适配器？

Laravel Eloquent 是 Laravel 框架中的一个强大的 ORM（对象关系映射）工具，它允许开发者以面向对象的方式与数据库进行交互。API 适配器通常用于将 Eloquent ORM 的功能适配到不同的 API 接口，以便在不同的应用场景中使用。

基础概念

API 适配器：是一种设计模式，用于将一个接口转换成客户端所期望的另一个接口形式。在 Laravel 中，API 适配器通常用于将 Eloquent ORM 的对象转换为适合 API 返回的格式，比如 JSON。

类型

数据转换适配器：将 Eloquent 对象转换为 API 所需的数据格式。
请求适配器：处理来自 API 的请求，并将其转换为 Eloquent 可以理解的参数。
响应适配器：将 Eloquent 的查询结果转换为 API 响应格式。

应用场景

微服务架构：在不同的微服务之间提供统一的数据访问接口。
前后端分离：为前端应用提供 RESTful 或 GraphQL API。
第三方集成：将内部系统的数据通过 API 暴露给外部系统。

示例代码

以下是一个简单的 Laravel Eloquent API 适配器的示例：

namespace App\ApiAdapters;

use App\Models\User;
use Illuminate\Support\Collection;

class UserAdapter
{
    public function toArray(User $user): array
    {
        return [
            'id' => $user->id,
            'name' => $user->name,
            'email' => $user->email,
            'created_at' => $user->created_at->toDateTimeString(),
            'updated_at' => $user->updated_at->toDateTimeString(),
        ];
    }

    public function toCollection(Collection $users): array
    {
        return $users->map(function ($user) {
            return $this->toArray($user);
        })->all();
    }
}

在控制器中使用这个适配器：

namespace App\Http\Controllers;

use App\ApiAdapters\UserAdapter;
use App\Models\User;
use Illuminate\Http\Request;

class UserController extends Controller
{
    protected $adapter;

    public function __construct(UserAdapter $adapter)
    {
        $this->adapter = $adapter;
    }

    public function index()
    {
        $users = User::all();
        return response()->json($this->adapter->toCollection($users));
    }

    public function show(User $user)
    {
        return response()->json($this->adapter->toArray($user));
    }
}