Laravel Collection Public API: toJson

toJson($options = 0)

The toJson method will return a JSON encoded version of the data stored within the collection instance. It internally does this by returning a call to PHP's json_encode function, passing in any $options that were supplied. Like the json_encode function, the $options parameter is a bitmask of the predefined JSON constants.

 1<?php
 2 
 3// Create a new collection instance.
 4$collection = new Collection([
 5    ['name' => 'Shirley', 'age' => 60],
 6    ['name' => 'John',    'age' => 55]
 7]);
 8 
 9// Convert the collection to JSON.
10$jsonValue = $collection->toJson();

After the above code executes, $jsonValue would contain the following value:

1[{"name":"Shirley","age":60},{"name":"John","age":55}]

Alternatively, a well-formatted value can be returned by passing in the JSON_PRETTY_PRINT constant:

 1<?php
 2 
 3// Create a new collection instance.
 4$collection = new Collection([
 5    ['name' => 'Shirley', 'age' => 60],
 6    ['name' => 'John',    'age' => 55]
 7]);
 8 
 9// Convert the collection to JSON.
10$jsonValue = $collection->toJson(JSON_PRETTY_PRINT);

This time, the $jsonValue would contain the following value:

 1[
 2    {
 3        "name": "Shirley",
 4        "age": 60
 5    },
 6    {
 7        "name": "John",
 8        "age": 55
 9    }
10]

#toJson and Deeply Nested Data Structures

The toJson method internally makes a call to PHP's json_encode function. Unlike json_encode, toJson does not provide a way to specify the depth (essentially how many arrays are nested inside of each other) to which data will be encoded, which is by default set to 512. To convert a collection instance into its JSON equivalent with a depth greater than 512, the following method will be sufficient:

1<?php
2 
3use Illuminate\Support\Collection;
4 
5// Create a new collection instance.
6$collection = new Collection([]);
7 
8// Replace 512 with the desired depth.
9$jsonValue = json_encode($collection->jsonSerialize(), 0, 512);

∎