[5.4] Add $num optional parameter to Arr::random()

src/Illuminate/Support/Arr.php

@@ -441,12 +441,25 @@ public static function pull(&$array, $key, $default = null)
     /**
      * Get a random value from an array.
      *
-     * @param  array   $array
+     * @param  array  $array
+     * @param  int    $num
      * @return mixed
      */
-    public static function random($array)
+    public static function random($array, $num = 1)
     {
-        return $array[array_rand($array)];
+        if ($num == 1) {
+            return $array[array_rand($array)];
+        }
+
+        $keys = array_rand($array, $num);
+
+        $results = [];
+
+        foreach ($keys as $key) {
+            $results[] = $array[$key];
+        }
+
+        return $results;
     }
 
     /**

src/Illuminate/Support/helpers.php

@@ -249,12 +249,13 @@ function array_pull(&$array, $key, $default = null)
     /**
      * Get a random value from an array.
      *
-     * @param  array   $array
+     * @param  array  $array
+     * @param  int    $num
      * @return mixed
      */
-    function array_random($array)
+    function array_random($array, $num = 1)
     {
-        return Arr::random($array);
+        return Arr::random($array, $num);
     }
 }
 

tests/Support/SupportArrTest.php

@@ -403,8 +403,14 @@ public function testRandom()
     {
         $randomValue = Arr::random(['foo', 'bar', 'baz']);
 
-        $this->assertInternalType('string', $randomValue);
         $this->assertContains($randomValue, ['foo', 'bar', 'baz']);
+
+        $randomValues = Arr::random(['foo', 'bar', 'baz'], 2);
+
+        $this->assertInternalType('array', $randomValues);
+        $this->assertCount(2, $randomValues);
+        $this->assertContains($randomValues[0], ['foo', 'bar', 'baz']);
+        $this->assertContains($randomValues[1], ['foo', 'bar', 'baz']);
     }
 
     public function testSet()