Serializarea Datelor API cu JsonResource și ResourceCollection în Laravel

routing Laravel 11.x / Eloquent Q&A / Distribuie cod

Stratul de transformare dedicat pentru API-uri: filtrarea câmpurilor returnate, formatarea datelor și structurarea răspunsurilor JSON conforme.

Sintaxă
class UserResource extends JsonResource { public function toArray(Request $request): array { ... } }

Returnarea directă a modelelor Eloquent din controllerele API este o practică riscantă deoarece poate expune coloane confidențiale din baza de date sau poate crea dependențe rigide între schema SQL și contractul frontend-ului.

JsonResource acționează ca un strat intermediar de transformare (Transformer Layer), permițând selectarea precisă a atributelor exportate, formatarea datelor calendaristice și includerea condiționată a relațiilor încărcate ($this->whenLoaded('comments')).

Exemplu: Resursă UserResource cu relație încărcată condiționat
namespace App\Http\Resources;

use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;

class UserResource extends JsonResource
{
    public function toArray(Request $request): array
    {
        return [
            'id' => $this->id,
            'name' => $this->name,
            'email' => $this->email,
            'created_at' => $this->created_at->toIso8601String(),
            'posts' => PostResource::collection($this->whenLoaded('posts')),
        ];
    }
}

// În controller:
// return new UserResource($user);
// return UserResource::collection(User::paginate(15));

Comunitate & Schimb de cunoștințe

Întrebări & Exemple de Cod: Serializarea Datelor API cu JsonResource și ResourceCollection

Ai o nelămurire despre utilizarea comenzii Serializarea Datelor API cu JsonResource și ResourceCollection sau ai descoperit un truc / fragment de cod util? Distribuie-l cu ceilalți programatori!

💬

Fii primul care pune o întrebare sau distribuie un fragment de cod / prompt!

Nu au fost adăugate încă întrebări sau exemple de cod pentru această pagină. Dacă ai întâlnit o problemă sau ai un snippet util, adaugă-l mai jos pentru a-i ajuta pe ceilalți.

Comunitate Adaugă o întrebare sau distribuie un cod

Moderare & Siguranță:

Pentru a menține calitatea și securitatea informațiilor, fiecare întrebare sau fragment de cod/prompt este analizat (manual sau prin moderare asistată de AI) înainte de publicare.