php man page for shuffle

SHUFFLE(3)								 1								SHUFFLE(3)

shuffle - Shuffle an array

SYNOPSIS
       bool shuffle (array  &$array)

DESCRIPTION
	This function shuffles (randomizes the order of the elements in) an array.

PARAMETERS
	      o $array
		- The array.

RETURN VALUES
	Returns TRUE on success or FALSE on failure.

EXAMPLES
       Example #1

	      shuffle(3) example

	      <?php
	      $numbers = range(1, 20);
	      shuffle($numbers);
	      foreach ($numbers as $number) {
		  echo "$number ";
	      }
	      ?>

NOTES
       Note

	      This  function assigns new keys to the elements in $array. It will remove any existing keys that may have been assigned, rather than
	      just reordering the keys.

SEE ALSO
       array_rand(3), The comparison of array sorting functions.

PHP Documentation Group 														SHUFFLE(3)