Laravel Collection Public API: random

random($amount = 1)

The random method will retrieve a random $amount of items from the collection. By default, the random method will return only one item, however a different $amount can be passed in to change the number of items returned. If the number of items returned is greater than one, a Collection instance is returned. If the number of items returned is exactly one, the individual item will be returned. If the $amount of items requested exceeds the total number of items in the collection, an InvalidArgumentException will be thrown.

 1<?php
 2 
 3use Illuminate\Support\Collection;
 4 
 5// Create a new collection instance.
 6$collection = new Collection([
 7    'first'  => 'I am first',
 8    'second' => 'I am second',
 9    'third'  => 'I am third'
10]);
11 
12// Randomly retrieve a single item.
13$random = $collection->random();
14 
15// Randomly retrieve a collection of items. The
16// returned value will be a Collection instance.
17$randomItems = $collection->random(2);

∎