موارد API والترقيم المحدود

<?php
namespace App\Http\Resources;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
class PostResource extends JsonResource
{
    public function toArray(Request $request): array
    {
        return [
            "id" => $this->id,
            "title" => $this->title,
            "published" => (bool) $this->published,
            "author" => $this->whenLoaded("author", fn () => [
                "id" => $this->author->getKey(),
                "name" => $this->author->name,
            ]),
        ];
    }
}

Loaded author Mira: id/title/published plus author id/name. Unloaded author: author key omitted.

يوفر التطبيق Post ويفحص المساعد تحميله دون جلب، ويستبعد البريد والجسم عمدا.

<?php
namespace App\Http\Controllers;
use App\Models\Post;
use App\Http\Resources\PostResource;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
class PublicPostIndexController extends Controller
{
    public function index(Request $request): AnonymousResourceCollection
    {
        $input = $request->validate(["per_page" => ["sometimes", "integer", "between:1,50"]]);
        $perPage = (int) ($input["per_page"] ?? 15);
        $posts = Post::query()->where("published", true)
            ->with("author:id,name")->orderBy("id")
            ->paginate($perPage)->appends(["per_page" => $perPage]);
        return PostResource::collection($posts);
    }
}

Fixture with published ids 1 and 3, draft id 2, per_page=1: first data row id 1; pagination total 2.

القائمة العامة المصطنعة تقيد الحقول والسجلات والحجم وتفترض التطبيق؛ لم تنفذ قاعدة.