Resource collections in Laravel - Step-by-Step Execution

Concept Flow - Resource collections

Controller calls Resource Collection

↓

Resource Collection wraps Models

↓

Transforms each Model to JSON

↓

Returns JSON response to client

The controller uses a resource collection to wrap multiple models, transform each into JSON, and send the JSON response.

Execution Sample

Laravel

use App\Http\Resources\UserCollection;

public function index() {
  return new UserCollection(User::all());
}

This code returns a resource collection wrapping all User models, transforming them into JSON.

Execution Table

Step	Action	Input	Output	Notes
1	Controller calls UserCollection	User::all() (list of users)	UserCollection instance	Wraps all users in collection
2	UserCollection iterates models	Each User model	Calls UserResource::toArray()	Transforms each user
3	UserResource transforms model	User model	Array with selected fields	E.g., id, name, email
4	UserCollection gathers transformed arrays	All transformed user arrays	Array of user arrays	Prepares JSON structure
5	UserCollection returns JSON response	Array of user arrays	JSON response sent to client	Final output
6	Client receives JSON	JSON response	Readable JSON data	Can be used by frontend or API consumer

💡 All users transformed and JSON response sent to client

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	Final
users	empty	Collection of User models	Same collection, iterated	Individual user arrays	Array of user arrays
resourceCollection	null	UserCollection instance wrapping users	Same instance	Same instance	JSON response

Key Moments - 3 Insights

Why does the controller return a UserCollection instead of raw User models?

Returning UserCollection ensures each User model is transformed consistently to JSON, as shown in execution_table step 2 and 3.

How does Laravel know which fields to include in the JSON?

The UserResource's toArray method defines which fields to include, referenced in execution_table step 3.

What happens if the collection is empty?

The UserCollection still returns an empty JSON array, as the iteration in step 2 has no models to transform.

Visual Quiz - 3 Questions

Look at the execution_table, what is the output at step 3?

A Array with selected user fields

B Raw User model

C UserCollection instance

D JSON response

💡 Hint

Check the 'Output' column in step 3 of execution_table

At which step does the JSON response get sent to the client?

A Step 2

B Step 4

C Step 5

D Step 6

💡 Hint

Look for 'returns JSON response' in the 'Action' column

If UserResource included a new field, how would the variable 'users' change after step 3?

A It would remain as raw User models

B It would include the new field in each user array

C It would become a JSON string

D It would be empty

💡 Hint

Refer to variable_tracker for 'users' after step 3 and execution_table step 3

Concept Snapshot

Resource collections wrap multiple models in Laravel.
They transform each model using a resource class.
The collection returns a JSON response.
Use in controllers to send consistent API data.
Empty collections return empty JSON arrays.

Full Transcript

In Laravel, resource collections help convert multiple models into JSON responses. The controller calls a resource collection with a list of models. The collection iterates over each model, transforming it using a resource class that defines which fields to include. Then, the collection gathers all transformed models into an array and returns it as a JSON response to the client. This process ensures consistent and clean API output. Even if the collection is empty, the response is a valid empty JSON array.