v2.2.0 updates

Author: robinsonjohn

CHANGELOG.md

@@ -12,6 +12,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `Fixed` for any bug fixes.
 - `Security` in case of vulnerabilities
 
+## [2.2.0] - 2025.07.22
+
+### Added
+
+- Added `exceptValues` and `getRandomItems` methods
+
 ## [2.1.0] - 2025.07.10
 
 ### Added

README.md

@@ -39,13 +39,15 @@ composer require bayfrontmedia/php-array-helpers
 - [pluck](#pluck)
 - [forget](#forget)
 - [except](#except)
+- [exceptValues](#exceptvalues)
 - [only](#only)
 - [missing](#missing)
 - [isMissing](#ismissing)
 - [multisort](#multisort)
 - [numericMultisort](#numericmultisort)
 - [renameKeys](#renamekeys)
 - [order](#order)
+- [getRandomItems](#getrandomitems)
 - [query](#query)
 - [getAnyValues](#getanyvalues)
 - [hasAnyValues](#hasanyvalues)
@@ -306,6 +308,35 @@ $array = Arr::except($array, 'active');
 
 <hr />
 
+### exceptValues
+
+**Description:**
+
+Returns the original array except given value(s).
+
+**Parameters:**
+
+- `$array` (array): Original array
+- `$values` (string|array): Values(s) to remove
+
+**Returns:**
+
+- (array)
+
+**Example:**
+
+```
+$array = [
+    'John',
+    'Jane',
+    'Bob'
+];
+
+$array = Arr::exceptValues($array, 'John');
+```
+
+<hr />
+
 ### only
 
 **Description:**
@@ -566,6 +597,38 @@ Array
 
 <hr />
 
+### getRandomItems
+
+**Description:**
+
+Get random items from array.
+
+If `$count` is greater than or equal to the number of items on the array,
+the original array is returned in random order.
+
+**Parameters:**
+
+- `$array` (array): Original array
+- `$count` (int): Number of random items to return
+
+**Returns:**
+
+- (array)
+
+**Example:**
+
+```
+$array = [
+    'John',
+    'Jane',
+    'Bob'
+];
+
+$array = Arr::getRandomItems($array, 1);
+```
+
+<hr />
+
 ### query
 
 **Description:**

src/Arr.php

@@ -227,6 +227,18 @@ public static function except(array $array, array|string $keys): array
         return array_diff_key($array, array_flip((array)$keys));
     }
 
+    /**
+     * Returns the original array except given value(s).
+     *
+     * @param array $array (Original array)
+     * @param array|string $values (Values to remove)
+     * @return array
+     */
+    public static function exceptValues(array $array, array|string $values): array
+    {
+        return array_values(array_diff($array, (array)$values));
+    }
+
     /**
      * Returns only desired key(s) from an array.
      *
@@ -375,6 +387,36 @@ public static function order(array $array, array $order): array
         return self::only(array_replace(array_flip($order), $array), array_keys($array));
     }
 
+    /**
+     * Get random items from array.
+     *
+     * If $count is greater than or equal to the number of items on the array,
+     * the original array is returned in random order.
+     *
+     * @param array $array (Original array)
+     * @param int $count (Number of random items to return)
+     * @return array
+     */
+    public static function getRandomItems(array $array, int $count): array
+    {
+
+        if (count($array) <= $count) {
+            $shuffled = $array;
+            shuffle($shuffled);
+            return $shuffled;
+        }
+
+        $keys = array_rand($array, $count);
+
+        // Ensure $keys is always an array
+        if (!is_array($keys)) {
+            $keys = [$keys];
+        }
+
+        return array_map(fn($key) => $array[$key], $keys);
+
+    }
+
     /**
      * Convert array into a query string.
      *