Laravel Collection Public API: merge

merge($items)

The merge methods merges the given $items with the items in the collection. The merge method will replace any item in the original collection's items if a string key with the same value exists in the supplied $items. If the $items keys are numeric, the new $items will be added to the end of the new collection's items. The merge method can accept either an array or a Collection instance. The merge method returns a new instance of Collection and does not modify the original collection instance.

 1<?php
 2 
 3use Illuminate\Support\Collection;
 4 
 5// Create a new collection instance.
 6$collection = new Collection([
 7    'first', 'second', 'third'
 8]);
 9 
10// Merge an array with the existing collection.
11$newCollection = $collection->merge(['fourth']);

After the above code has executed, the $newCollection variable will be an instance of Collection and contain a value similar to the following output:

1object(Illuminate\Support\Collection)[134]
2  protected 'items' =>
3    array (size=4)
4      0 => string 'first' (length=5)
5      1 => string 'second' (length=6)
6      2 => string 'third' (length=5)
7      3 => string 'fourth' (length=6)

∎