API 리소스 및 JSON 응답

API 리소스란 무엇입니까?

리소스 생성

$ php artisan make:resource UserResource
# For collections:
$ php artisan make:resource UserCollection

기본 리소스

<?php
namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\JsonResource;

class UserResource extends JsonResource
{
    public function toArray($request): array
    {
        return [
            "id"         => $this->id,
            "name"       => $this->name,
            "email"      => $this->email,
            "created_at" => $this->created_at->toISOString(),
        ];
    }
}

리소스 반환

<?php
public function show(User $user): UserResource
{
    return new UserResource($user);
}
// Response: {"data": {"id": 1, "name": "Alice", ...}}

리소스 컬렉션

<?php
public function index(): AnonymousResourceCollection
{
    return UserResource::collection(User::paginate(15));
}

조건부 필드

<?php
return [
    "id"    => $this->id,
    "email" => $this->when($request->user()?->isAdmin(), $this->email),
    "token" => $this->whenLoaded("tokens", $this->tokens->first()->plainTextToken),
];

whenLoaded()

<?php
return [
    "id"      => $this->id,
    "posts"   => PostResource::collection($this->whenLoaded("posts")),
    "profile" => new ProfileResource($this->whenLoaded("profile")),
];

중첩 리소스

<?php
return [
    "id"     => $this->id,
    "author" => new UserResource($this->author),
    "tags"   => TagResource::collection($this->tags),
];

추가 메타데이터

<?php
public function with($request): array
{
    return [
        "meta" => ["version" => "1.0"],
    ];
}

래핑

<?php
// In AppServiceProvider::boot():
JsonResource::withoutWrapping();

리소스의 페이지 매김

<?php
return UserResource::collection(User::paginate(15));
// Response includes: data[], links{}, meta{}

리소스 테스트

<?php
$response->assertJsonStructure([
    "data" => ["id", "name", "email"]
]);

요약

빠른 확인