Resource collections in Laravel - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is a Resource Collection in Laravel?

A Resource Collection in Laravel is a way to transform a group of models into a JSON-friendly format, making it easy to control how data is sent in API responses.

beginner

How do you create a Resource Collection in Laravel?

You create a Resource Collection by running the artisan command: <code>php artisan make:resource NameCollection</code>. This generates a class to format a collection of models.

intermediate

What method do you override to customize the output of a Resource Collection?

You override the <code>toArray()</code> method in the Resource Collection class to define how each item in the collection should be transformed.

intermediate

How does a Resource Collection differ from a single Resource in Laravel?

A Resource transforms a single model instance, while a Resource Collection transforms a group of models, usually returning an array of transformed items.

beginner

Why use Resource Collections instead of returning raw model data?

Resource Collections help control and standardize the API output, hide sensitive data, and format data consistently, improving security and clarity for API consumers.

Which artisan command creates a Resource Collection in Laravel?

A php artisan make:resource NameCollection

B php artisan make:collection Name

C php artisan make:model NameCollection

D php artisan make:resourcecollection Name

The correct command is php artisan make:resource NameCollection to create a Resource Collection.

What method do you customize to change the JSON output of a Resource Collection?

A format()

B toJson()

C render()

D toArray()

You override the toArray() method to customize the output format.

What does a Resource Collection usually return?

A A single model instance

B An array of transformed model data

C Raw database query results

D HTML views

Resource Collections return an array of transformed model data, suitable for APIs.

Why is it better to use Resource Collections instead of returning raw models?

A They hide sensitive data and format output

B They make the app slower

C They increase database size

D They automatically create views

Resource Collections help hide sensitive data and format the API output consistently.

Can you use a Resource Collection to transform a single model?

A Yes, always

B No, only collections

C Yes, but it's better to use a single Resource

D No, it causes errors

While possible, it's better to use a single Resource for one model and Resource Collection for many.

Explain what a Laravel Resource Collection is and why you would use it in an API.

Think about how you send lists of data to apps or websites.

Describe the steps to create and customize a Resource Collection in Laravel.

Start with the command, then change the output format.

Practice

1. What is the primary purpose of using ::collection() in Laravel resource classes?

easy

A. To delete multiple records from the database

B. To create a single model instance

C. To format multiple model instances consistently in API responses

D. To validate incoming request data

Solution

1. Step 1: Understand the role of resource collections

   Resource collections are used to format many items in the same way for API responses.

2. Step 2: Identify what ::collection() does

   The ::collection() method wraps multiple model instances to apply the resource formatting to each item.

3. Final Answer:

   To format multiple model instances consistently in API responses -> Option C

4. Quick Check:

   Resource collections format many items = A [OK]

Hint: Remember: ::collection() wraps many models for consistent output [OK]

Common Mistakes:

• Confusing ::collection() with single model resource
• Thinking it deletes or modifies database records
• Mixing it up with validation methods

2. Which of the following is the correct syntax to return a resource collection for a list of users stored in $users using a resource class UserResource?

easy

A. return UserResource::collection($users);

B. return new UserResource($users);

C. return UserResource::make($users);

D. return UserResource::all($users);

Solution

1. Step 1: Recall the syntax for resource collections

   To format multiple models, use ::collection() on the resource class with the collection as argument.

2. Step 2: Match the syntax with options

   return UserResource::collection($users); uses UserResource::collection($users); which is correct. Other options either create a single resource or use invalid methods.

3. Final Answer:

   return UserResource::collection($users); -> Option A

4. Quick Check:

   Correct syntax for collections = D [OK]

Hint: Use ::collection() for multiple items, not new [OK]

Common Mistakes:

• Using new UserResource($users) for collections
• Using non-existent methods like all() or make()
• Confusing single resource and collection syntax

3. Given the following code, what will be the output structure of the API response?

return UserResource::collection($users)->additional(['meta' => ['total' => $users->count()]]);

medium

A. A plain array of user models without formatting

B. A JSON with only a 'meta' object and no user data

C. A JSON with a 'data' array but no meta information

D. A JSON with a 'data' array of users and a 'meta' object containing total count

Solution

1. Step 1: Understand additional() method usage

   The additional() method adds extra data (like meta info) to the resource collection response.

2. Step 2: Analyze the returned structure

   The response will have a data key with formatted users and a meta key with the total count from additional().

3. Final Answer:

   A JSON with a 'data' array of users and a 'meta' object containing total count -> Option D

4. Quick Check:

   Collection + additional meta = data + meta JSON [OK]

Hint: Remember additional() adds extra keys outside 'data' [OK]

Common Mistakes:

• Expecting meta inside each user item instead of outside
• Thinking additional() replaces data instead of adding
• Confusing plain arrays with resource formatted output

4. Identify the error in the following code snippet that tries to return a resource collection:

return UserResource::collection()->additional(['status' => 'success']);

medium

A. Missing the collection argument inside collection()

B. Using additional() is not allowed on collections

C. Should use new UserResource() instead of collection()

D. The additional() method requires a string, not an array

Solution

1. Step 1: Check the usage of collection()

   The collection() method requires a collection or array argument to wrap. Here it is called without any argument.

2. Step 2: Validate other method usages

   additional() can be used on collections and accepts an array. Using new UserResource() is for single models, not collections.

3. Final Answer:

   Missing the collection argument inside collection() -> Option A

4. Quick Check:

   collection() needs argument [OK]

Hint: Always pass your data to collection() [OK]

Common Mistakes:

• Calling collection() without data
• Thinking additional() is invalid on collections
• Confusing single resource and collection usage

5. You want to return a paginated list of posts with a resource collection and include extra pagination info under a meta key. Which code snippet correctly achieves this?

hard

A. return PostResource::collection($posts->paginate(10))->additional(['meta' => ['current_page' => $posts->currentPage()]]);

B. return PostResource::collection($posts->paginate(10))->additional(['meta' => ['current_page' => $posts->paginate(10)->currentPage()]]);

C. return PostResource::collection($posts)->additional(['meta' => ['current_page' => $posts->currentPage()]]);

D. return new PostResource($posts->paginate(10))->additional(['meta' => ['current_page' => $posts->paginate(10)->currentPage()]]);

Solution

1. Step 1: Understand pagination and resource collections

   When paginating, call paginate(10) on the query to get a paginator instance. Pass this to collection().

2. Step 2: Access pagination info correctly

   To access currentPage(), it must be called on the paginator returned by paginate(), not on the original query builder $posts.

3. Step 3: Identify correct option

   The snippet that calls $posts->paginate(10)->currentPage() within additional() correctly retrieves the current page from a paginator instance, ensuring the paginated data and meta align.

4. Final Answer:

   return PostResource::collection($posts->paginate(10))->additional(['meta' => ['current_page' => $posts->paginate(10)->currentPage()]]); -> Option B

5. Quick Check:

   paginate() result for both collection and currentPage() [OK]

Hint: Access pagination methods on paginate() result, not query builder [OK]

Common Mistakes:

• Calling currentPage() on query builder $posts
• Passing unpaginated $posts to collection()
• Using new Resource() for paginated collections