How to Randomly Shuffle Array Elements Using PHP's shuffle Function

Randomly shuffling the elements of an array is a common task in game development, password generation, and other scenarios. PHP provides the built‑in shuffle function to achieve this.

shuffle function basic syntax

shuffle(array &$array): bool

The $array parameter is the array to be shuffled; the function modifies the array in place and returns a boolean indicating success.

shuffle function example

$myArray = array("apple", "banana", "cherry", "durian", "elderberry");

// Shuffle the array
shuffle($myArray);

// Output the shuffled array
foreach ($myArray as $value) {
    echo $value . " ";
}

The output might be something like: elderberry banana cherry durian apple Note that shuffle changes the original array order and does not return a new array. If you need to keep the original, create a copy first, for example using array_slice, and then shuffle the copy. shuffle works with associative and multidimensional arrays as well; for associative arrays it randomises the order of key‑value pairs, and for multidimensional arrays it shuffles the elements within each sub‑array.

Using PHP's shuffle function makes it easy to add randomness to applications.