array_rand

(PHP 4, PHP 5, PHP 7)

array_rand 从数组中随机取出一个或多个单元

说明

array_rand ( array $array [, int $num = 1 ] ) : mixed

从数组中取出一个或多个随机的单元,并返回随机条目的一个或多个键。 它使用了伪随机数产生算法,所以不适合密码学场景,

参数

array

输入的数组。

num

指明了你想取出多少个单元。

返回值

如果只取出一个,array_rand() 返回随机单元的键名。 否则就返回包含随机键名的数组。 完成后,就可以根据随机的键获取数组的随机值。 取出数量如果超过 array 的长度,就会导致 E_WARNING 错误,并返回 NULL。

更新日志

版本 说明
7.1.0 内置的随机数生成算法从 libc rand 函数改成» 梅森旋转 伪随机数生成算法。
5.2.10 The resulting array of keys is no longer shuffled.

范例

Example #1 array_rand() 例子

<?php
$input 
= array("Neo""Morpheus""Trinity""Cypher""Tank");
$rand_keys array_rand($input2);
echo 
$input[$rand_keys[0]] . "\n";
echo 
$input[$rand_keys[1]] . "\n";
?>

参见

User Contributed Notes

akalongman at gmail dot com 08-Aug-2018 11:38
I'd recommend use random_int() instead of mt_rand()
grzeniufication 03-Mar-2018 10:19
<?php

/**
 * Wraps array_rand call with additional checks
 *
 * TLDR; not so radom as you'd wish.
 *
 * NOTICE: the closer you get to the input arrays length, for the n parameter, the  output gets less random.
 * e.g.: array_random($a, count($a)) == $a will yield true
 * This, most certainly, has to do with the method used for making the array random (see other comments).
 *
 * @throws OutOfBoundsException - if n less than one or exceeds size of input array
 *
 * @param array $array - array to randomize
 * @param int $n - how many elements to return
 * @return array
 */
function array_random(array $array, int $n = 1): array
{
    if (
$n < 1 || $n > count($array)) {
        throw new
OutOfBoundsException();
    }

    return (
$n !== 1)
        ?
array_values(array_intersect_key($array, array_flip(array_rand($array, $n))))
        : array(
$array[array_rand($array)]);
}
grzeniufication 03-Mar-2018 09:22
<?php
// An example how to fetch multiple values from array_rand
$a = [ 'a', 'b', 'c', 'd', 'e', 'f', 'g' ];
$n = 3;

// If you want to fetch multiple values you can try this:
print_r( array_intersect_key( $a, array_flip( array_rand( $a, $n ) ) ) );

// If you want to re-index keys wrap the call in 'array_values':
print_r( array_values( array_intersect_key( $a, array_flip( array_rand( $a, $n ) ) ) ) );
enanda dot am at gmail dot com 13-Oct-2017 11:54
We can use this function to create random HEX Color codes :

<? php

    $color='#';

    $colors = array (0,1,2,3,4,5,6,7,8,9,'A','B','C','D','E','F');

    for($i=0;$i<6;$i++){

        $color.=$colors[array_rand($colors)];

    }
       
         echo $color;

?>

So each time we ran this script it will generate a random HEX color code and print it in the screen .
notmuqsit at gmail dot com 27-Sep-2017 11:36
When the second argument is greater than 1, the output array will be arranged in ascending order.

$a = ["Albert", "James", "Steve", "Charlie", "Sarah"];

The least value of array keys of $a is 0 and the highest is 4 in this case. Now let's do some tests.

//Infinite loops (never ending loops)
while(array_rand($a, 2)[0] !== 4);
while(array_rand($a, 2)[1] !== 0);

//Non-infinite loops.
while(array_rand($a, 2)[0] === 0);
while(array_rand($a, 2)[1] === 4);

Why is this important?
You will never get a perfectly random key if you aren't aware of that.

array_rand($a, 2)[0] will NEVER return the last key (by the last key I mean the last key of the array when you arrange the array keys in ascending order).

array_rand($a, 2)[1] will NEVER return the first key (by the first key I mean the first key of the array when you arrange the array keys in ascending order).

In our case,

$random = array_rand($a, 2);
echo $a[$random[0]];//Possible output: "Albert", "James", "Steve" or "Charlie"
echo $a[$random[1]];//Possible output: "James", "Steve", "Charlie" or "Sarah"

You might want to shuffle($random) in such a case. This is only needed IF you have defined the second parameter and the second parameter > 1.
sondermann dot m at gmail dot com 17-Nov-2016 03:41
It is not written on here but you should note that the keys that are returned are always sorted low to high.
This was unexpected for me since my main reason to use this function was to get a random subset of an array (use case was to list products in a sidebar).

As a result of this, even if the same products were picked randomly another time, they were always arranged in the same way.

This is my solution, may help someone who also needs a fully randomized subset of an array:

<?php
function array_random_keys( $array, $num = 1 ) {
        if ( !
is_array( $array ) ) return $array;
        if( (int)
$num < 1 ) return array();
       
$keys = array_keys($array);
       
shuffle($keys);
        if(
$num == 1 ) {
          return
$keys[0];
        }
        return
array_splice( $keys, 0, $num );
}
?>
divinity76 at gmail dot com 15-Oct-2016 01:59
if you're looking for a cryptographically secure variant (as of speaking, php uses mt_rand), i made this. (limitations: it has no $num parameter. it requires php>=7)

<?php
function csarray_rand(array $arr){
   
$keys=array_keys($arr);
   
$count=count($keys);
    if(
$count===0){
       
//Contrary to documentation, PHP 4 and 5 and 7, up to php 7.1.0alpha3 does not actually return any warning when the array is empty and $num=NULL (and further contradicting the documentation, its NULL by default, not 1, and they are treated differently, 1 gives error, NULL does not.) ... 7.1.0beta1 does throw an error however... follow their example?
       
if(version_compare(PHP_VERSION,'7.1.0beta1','>=')){
           
trigger_error('Warning: csarray_rand(): Array is empty',E_USER_ERROR);
        }
        return
NULL;
    }
   
$csrand=random_int(0,count($keys)-1);
    return
$keys[$csrand];
}
?>
mike at eastghost dot com 04-Jun-2015 09:13
Verified 2015-06-03 -- this function produces VERY uneven "random" distribution.
Wirek 16-Apr-2015 11:43
I agree with Sebmil (http://php.net/manual/en/function.array-rand.php#105265) that "array_rand()" produces weird and very uneven random distribution (as of my local PHP 5.3.8 and my public host's PHP 5.2.17).
Unfortunately, I haven't got any access either to a server with the latest PHP version. My info is for those of you who like to check things for themselves and who don't believe all of the official statements in the docs.
I've made a simple adjustment of his test code like this:
<?php
$s
=1;    // Start value
$c=50;    // Count / End value
$test=array_fill($s, $c, 0);
$ts=microtime(true);
for(
$i=0; $i<5000000; $i++){
   
$idx=mt_rand($s, $c);    // Try it with rand() - simpler but more evenly distributed than mt_rand()
   
$test[$idx]++;
}
$te=microtime(true);
$te=($te-$ts)*1000.0;    // Loop time in miliseconds

asort($test);
echo
"Test mt_rand() in ".$te." ms: <br/>\n";
foreach(
$test as $k=>$v) echo "$k :\t$v <br/>\n";
?>

And it appears to me that simple "$idx=rand(0, count($test)-1);" is much better than "$idx=array_rand($test, 1);".
And what's more the simpler and a bit slower (0 ms up to total 712.357 ms at 5 mln cycles) "rand()" is better than "mt_rand()" in simple everyday use cases because it is more evenly distributed (difference least vs. most often numbers: ca. 0.20-1.28 % for "rand()" vs. ca. 1.43-1.68 % for "mt_rand()").
Try it for yourself... although it depends on your software and hardware configuration, range of numbers to choose from (due to random patterns), number of cycles in the loop, and temporary (public) server load as well.
compolom at gmail dot com 13-Feb-2015 04:17
/*
useful function to sort an array randomly
*/
function sort_array_rand($array) {
    $result = array();
    $y = sizeof($array);
    $x = 0;          
    while ($x < pow($y, 2)) {
        $result[] = $array[array_rand($array)];
        $x++;
    }
    return array_unique($result);
}
Tmy Adeson 08-Jan-2015 02:29
<?php
// You can do this, programmatically, using the following code ... Test It Yourself (TIY)

$colors=array(
   
'gray','red','orange','green',
   
'#B2CC80','#CC6699','#B89470','#99CCFF',
);
//colors array

$c1=sizeof($colors)-1;//get position of the last element within the colors array

//    -- OR, if you prefer --
//$c1=count($colors)-1;//get position of the last element within the colors array

//pick a color at random from the colors array - 'Mersenne Twister based'
$color=$colors[mt_rand(0,$c1)];

echo<<<HERE
<!DOCTYPE html>
<html>
 <head>
   <meta http-equiv="refresh" content="2">
 </head>
 <body>
   <div style="width:400px; background-color:
$color; border:1px; text-align:center;" >
    
$color
   </div>
 </body>
</html>
HERE;
?>
yopai 08-Jan-2015 01:21
@Sebmil :
You say this function "has a strange randomness [, because] the 31st one is always by far the less occuring (by about 10% less than others)."

That's right (at least under linux, PHP 5.3). And it's also visible when calling array_rand with 1 as second parameter.

After checking the code, and testing it, I concluded that you have to call srand() at each iteration of your loop.

To be simple, a rand() call is made <n> times when the <n>th key is returned;
I suppose there is a flaw in the pseudorandom number generator (PRNG)  that php uses; somehow the generation has a frequency of 31 (when a random number is sufficiently low, then the 31st after it will be more higher).

Reinitializing the PRNG each time you enter the loop make the problem disappear (and is cheaper, in terms of time, than using shuffle).

In other words, the following code :
for ($i = 0; $i < 10000; ++$i)
{
    /* reinitialize the PRNG --> */ srand();
    $tirage_tab = array_rand($valeurs, 10);
    foreach($tirage_tab as $key => $value)
    {
        $proba[$valeurs[$value]]++;
    }
}

doesn't have the strange behaviour you noticed. No PRNG is perfectly random, so taking the habit of calling srand() from time to time is still a good practice if you rely on a lot of random numbers.
BenedictLemieux at gmail dot com 14-Sep-2014 03:31
Two things always bugged me with array_rand().

First is its name. It does not sound clear enough whether it gives key or values.

Second and more importantly is its erratic randomness, which is already well documented.

That is why I came up with these two simple functions:

<?php
function random_key($array){
   
$keys=array_keys($array);
    return
$keys[mt_rand(0, count($keys) - 1)];
}   
function
random_value($array){
   
$values=array_values($array);
    return
$values[mt_rand(0, count($values) - 1)];
}
?>

They both work well with any kind of arrays, do not alter the original one like shuffle, are giving more realistic random results, and their names are self describing.

The main drawback is that, as opposed to array_rand, they only gives one element, but at least that is clear from their name. I do believe easy to make random_keys and random_values.
marco at behnke dot biz 12-Sep-2014 01:52
Is there a difference in randomness if you use shuffle instead?

<?php
function array_shuffle($input, $num_of_results) {
   
shuffle($input);
    return
array_chunk($input, $num_of_results, true)[0];
}

$input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
var_dump(array_shuffle($input, 2));

/*
array(2) {
  [0]=>
  string(3) "Neo"
  [1]=>
  string(8) "Morpheus"
}
*/
?>

And yes, I know that my example returns a portion of the array and not just the key numbers
john at brahy dot com 07-May-2014 11:00
if you want random elements from an array, this worked pretty well for me.

<?php
//using shuffle randomizes the order of elements

function get_random_elements( $array,$limit = 0 ) {
   
   
shuffle($array);

    if (
$limit > 0 ) {
       
$array = array_splice($array, 0, $limit);
    }
    return
$array;
}
?>
nospamplease at mail dot com 13-Aug-2013 02:18
Random choice with a closure.

$randomChoice  = function($array) {return $array[array_rand($array)];};

$names = ['Dexter', 'Esther', 'David', 'Richard', 'Rachel', 'Belinda'];

echo $randomChoice($names);
Jordan Doyle 19-May-2013 09:49
Note: array_rand uses the libc generator, which is slower and less-random than Mersenne Twister.

<?php
    $a
= ['http://php.net/', 'http://google.com/', 'http://bbc.co.uk/'];

   
$website = $a[mt_rand(0, count($a) - 1)];
?>

This is a better alternative.
Anonymous 13-Jul-2012 02:42
It doesn't explicitly say it in the documentation, but PHP won't pick the same key twice in one call.
qeremy 07-Mar-2012 01:18
An example for getting random value from arrays;

<?php
function array_random($arr, $num = 1) {
   
shuffle($arr);
   
   
$r = array();
    for (
$i = 0; $i < $num; $i++) {
       
$r[] = $arr[$i];
    }
    return
$num == 1 ? $r[0] : $r;
}

$a = array("apple", "banana", "cherry");
print_r(array_random($a));
print_r(array_random($a, 2));
?>

cherry
Array
(
    [0] => banana
    [1] => apple
)

And example for getting random value from assoc arrays;

<?php
function array_random_assoc($arr, $num = 1) {
   
$keys = array_keys($arr);
   
shuffle($keys);
   
   
$r = array();
    for (
$i = 0; $i < $num; $i++) {
       
$r[$keys[$i]] = $arr[$keys[$i]];
    }
    return
$r;
}

$a = array("a" => "apple", "b" => "banana", "c" => "cherry");
print_r(array_random_assoc($a));
print_r(array_random_assoc($a, 2));
?>

Array
(
    [c] => cherry
)
Array
(
    [a] => apple
    [b] => banana
)
Sebmil 05-Aug-2011 12:18
Looks like this function has a strange randomness.

If you take any number of elements in an array which has 40..100 elements, the 31st one is always by far the less occuring (by about 10% less than others).

I tried this piece of code at home (PHP Version 5.3.2-1ubuntu4.9) and on my server (PHP Version 5.2.17), unfortunately i haven't any server with the last version here :

<?php
$valeurs
= range(1, 40);
$proba = array_fill(1, 40, 0);
for (
$i = 0; $i < 10000; ++$i)
{
   
$tirage_tab = array_rand($valeurs, 10);
    foreach(
$tirage_tab as $key => $value)
    {
       
$proba[$valeurs[$value]]++;
    }
}

asort($proba);
echo
"Proba : <br/>\n";
foreach(
$proba as $key => $value)
{
    echo
"$key : $value<br/>\n";
}
?>

In every try, the number of occurrences change a bit but the 31 is always far less (around 2200) than the others (2400-2600). I tried with 50 and 100 elements, no change. I tried with more or less elements to pick (second parameter to array_rand), same result. If you pick only one element it's even worse : 31 has half the result of the others.

For this particular case, i recommend shuffling the array and taking the nth first elements, in this test it's 60% faster and the statistics are ok.
Anonymous 02-Oct-2009 01:04
If the array elements are unique, and are all integers or strings, here is a simple way to pick $n random *values* (not keys) from an array $array:

<?php array_rand(array_flip($array), $n); ?>
info at pavliga dot com 28-Dec-2008 01:52
If you want get unique range:

<?php
$n
= 15;

$data = range(1, 20);
$rand = array_rand($data,$n);

for(
$i=0; $i<$n; $i++)
{
echo
$rand[$i]."<br>";
}

?>
admin at jeremyzaretski dot com 15-Dec-2008 08:11
<?php
// a foreach friendly version of array_rand
function Select_Random_Indices($source_array, $count = 1)
{
    if(
$count > 0)
    {
        if(
$count == 1)
        {
           
$result = array(array_rand($source_array, $count));
        }
        else
        {
           
$result = array_rand($source_array, $count);
        }
    }
    else
    {
       
$result = array();
    }

    return
$result;
}

// using the above function to pick random values instead of entries
function Select_Random_Entries($source_array, $count = 1)
{
   
$result = array();
   
$index_array = Select_Random_Indices($source_array, $count);

    foreach(
$index_array as $index)
    {
       
$result[$index] = $source_array[$index];
    }

    return
$result;
}
?>
herodesh [-at_] gmail [-dot-] com 05-Sep-2007 03:36
this is to generate a random selection from an array with array_rand preety nice, can be used to generate random passwords or anything:

$my_array = array("a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "0", "1", "2", "3", "4", "5");
        for ($i=0; $i<=10; $i++)
        {
            $random = array_rand($my_array);
                        //this generates the random number from the array
            $parola .= $my_array[$random];
                        //here we will display the exact charachter from the array
        }
        echo $parola; // printing result
Frederick Lemasson aka djassper at gmail 04-Dec-2006 12:57
To select a random Value (not a Key) from a Multi-Dimentionnal array I made a recursive function : array_multi_rand()

the following exemple randomly selects an url from a multidimentionnal array :

<?

$Expos['Google']['Science']='news.google.fr/news?topic=t';
$Expos['Google']['Economie']='news.google.fr/news?topic=b';
$Expos['Google']['Sante']='news.google.fr/news?topic=m';
$Expos['Yahoo']='fr.news.yahoo.com';
$Expos['Events']['LogicielLibre']='agendadulibre.org';
$Expos['MyBlog']='www.kik-it.com';

function array_multi_rand($Zoo){
    $Boo=array_rand($Zoo);
    if(is_array($Zoo[$Boo])){
        return array_multi_rand($Zoo[$Boo]);
    }else{
        return $Zoo[$Boo];
    }
}

echo(array_multi_rand($Expos));

?>
JS 04-Sep-2006 03:07
I wanted to write something that picks a random entry from a 1column-MySQL database - simply Post Of The Moment (potm). I know there surly are many better ways to do it, but I`m rather new to PHP :)  Anyway, it`s simple and no-problem working code.
Of course I assume your DB exists and you always have something in it.

@$link = MySQL_Connect("localhost", "username", "password"); //connect to mysql
mySQL_Select_DB("database"); //..to DB
@$potms = MySQL_Query("SELECT * FROM potm"); //now we get all from our table and store it
MySQL_Close($link); //there`s no need for connection, so we should close it

$potm_array = ''; //sets variables to "zero" values
$i = 0;
while ($entry = MySQL_Fetch_Array($potms)) //now we go through our DB
       {
         $potm_array[$i] = $entry; //our temporary array from which we will random pick a field key
         $i++; //now we increment our field key
       }

$potm_id = array_rand($potw_array); //picks a random key from array
$potm = $potm_array[$potm_id]['name_of_the_field']; //now we have stored our Post Of The Moment in $potm

..hope this helps
dragonfly at dragonflyeye dot net 07-Jul-2006 07:57
Well, this is interesting.   I don't see anyone else commenting on this, so just in case you were planning to use this function like I was, be prepared: array_rand does not handle multidimensional arrays.  It just ends up returning a list of the X-axis values without the Y-axis arrays.  Bummer.  I'm going to have to find another way to do what I wanted.
trukin at gmail dot com 16-Mar-2006 01:23
Modify of last note:
<?php
if (!function_exists('array_rand')) {
    function
array_rand($array, $lim=1) {
       
mt_srand((double) microtime() * 1000000);
        for(
$a=0; $a<=$lim; $a++){
           
$num[] = mt_srand(0, count($array)-1);
        }
        return @
$num;
    }
}
?>

mt_rand generates a better random number, and with the limit.
Will-ster 01-Jan-2006 04:18
This is something I have been playing with for quite awhile. I'm very new to php, but i finally got it to work. it's a function that will take and array[$arrquo] and find a particular keyword[$find] in the different elements of the array then take those elements that posess that keyword and display them at random

<?php
function popbyword($arrquo,$find)
{
$newarr = array('');
 foreach(
$arrquo as $line)
 {
  if(
strstr( $line, $find ) )
  {
   
array_push($newarr, $line);
 
  }
 }   
srand((double)microtime()*1000000);
$rquote = array_rand($newarr);
echo
$newarr[$rquote];
}

popbyword($images, 'Albert');
?>

In my case I had this huge array of quotes with 90 some elements. I was able to find certain keywords in those elements then ONLY display the elements that had those keywords. NEAT! Maybe only because I'm new.
bjcffnet at gmail dot com 29-Aug-2005 04:29
As wazaawazaa600 at msn dot com pointed out, a multi-dimensional array doesn't work with this function. So, I hope I can help someone with this :)

<?php
/**
 * Returns a number of random elements from an array.
 *
 * It returns the number (specified in $limit) of elements from
 * $array. The elements are returned in a random order, exactly
 * as it was passed to the function. (So, it's safe for multi-
 * dimensional arrays, aswell as array's where you need to keep
 * the keys)
 *
 * @author Brendan Caffrey  <bjcffnet at gmail dot com>
 * @param  array  $array  The array to return the elements from
 * @param  int    $limit  The number of elements to return from
 *                            the array
 * @return array  The randomized array
 */
function array_rand_keys($array, $limit = 1) {
   
$count = @count($array)-1;

   
// Sanity checks
   
if ($limit == 0 || !is_array($array) || $limit > $count) return array();
    if (
$count == 1) return $array;

   
// Loop through and get the random numbers
   
for ($x = 0; $x < $limit; $x++) {
       
$rand = rand(0, $count);

       
// Can't have double randoms, right?
       
while (isset($rands[$rand])) $rand = rand(0, $count);

       
$rands[$rand] = $rand;
    }

   
$return = array();
   
$curr = current($rands);

   
// I think it's better to return the elements in a random
    // order, which is why I'm not just using a foreach loop to
    // loop through the random numbers
   
while (count($return) != $limit) {
       
$cur = 0;

        foreach (
$array as $key => $val) {
            if (
$cur == $curr) {
               
$return[$key] = $val;

               
// Next...
               
$curr = next($rands);
                continue
2;
            } else {
               
$cur++;
            }
        }
    }

    return
$return;
}
?>
alexkropivko at(dog) yandex dot ru 16-Jun-2005 06:21
There was a mistake at "Paul Hodel (paul at ue dot com dot br) 17-Apr-2003 04:40":
String
echo $new_input = $input[$v];

have to be:
echo $new_input[] = $input[$v];
maxnamara at yahoo dot com 13-Mar-2005 03:22
<?php
$input
= array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");

function
my_array_rand($input,$i=2){
srand((float) microtime() * 10000000);

$rand_keys = array_rand($input, $i);

/*
print $input[$rand_keys[0]] . "\n";
print $input[$rand_keys[1]] . "\n";
*/

$res = array();

if(
$i > 1){

for(
$a=0;$a<$i;$a++){

   
$res[] = $input[$rand_keys[$a]];
   
}

}
else{

   
$res[] = $input[$rand_keys];   
   
}

return
$res;
}

$a = my_array_rand($input,3);
echo
"<pre>";
print_r($a);
echo
"</pre>";
?>
yhoko at yhoko dot com 27-Aug-2004 06:16
According to office at at universalmetropolis dot com I have to say that the example is wrong.

<?php
// retrieve one of the options at random from the array
$teamcolours = $teamcolours[rand(0,count($teamcolours))];
?>

The count() function will return the number of items in the array, that's the last index + 1. So if there's 2 items in the array, count() will return 2 but the indices are 0 and 1. Now since rand(x,y) randomizes between x and y inclusively the index from the above example may be out of bounds. Thus you have to subtract 1 from the count:

<?php
   
// Get random item
   
$teamcolours = $teamcolours[rand(0,count($teamcolours)-1)];
?>
jpinedo 02-Nov-2003 01:15
An array of arrays example:

<?php
$banners
[0]['imagen']="imagen0.gif";
$banners[0]['url']="www.nosenada.tal";

$banners[1]['imagen']="imagen1.gif";
$banners[1]['url']="www.nose.tal";

$banners[2]['imagen']="imagen2.gif";
$banners[2]['url']="pagina.html";

$banners[3]['imagen']="imagen3.jpg";
$banners[3]['url']="../pagina.php";

$id_banner = array_rand($banners);

echo 
"Archivo:--".$banners[$id_banner]['imagen']. "<br />\n";
echo 
"URL:-----".$banners[$id_banner]['url']. "<br />\n";
?>
asarnoNOSPAM@interbaun DOT com 23-Jun-2003 11:06
It is correct that using array_rand() with num_req=1 will return an integer and not an array, but why get so complicated with getting just the one value.  The K.I.S.S. method would suggest to do it this way:

<?
srand((double)microtime() * 10000000);
$originalArray = array("red", "blue", "green", "brown",
"cyan", "magenta", "purle", "cheezy");
$pickOne = array_rand($originalArray, 1);
$aRandomSelection = $originalArray[$pickOne ];
echo "$aRandomSelection was the random selection made";
?>

You only need to use the foreach if the num_req >=2. In those cases the array_rand() function will return an array of random elements which are a subset of the original array.  When num_req = 1, the array_rand() function returns an integer that signifies a randomly picked key of the original array.  Hope this clarifies things ... it works for me.
Paul Hodel (paul at ue dot com dot br) 17-Apr-2003 01:40
If you trying to get a randon array just use that... it's easier! And you have no repeats...

<?

srand ((float) microtime() * 10000000);

$input = array ("Neo", "Morpheus", "Trinity", "Cypher", "Tank");

$keys = array_rand ($input, sizeof($input));

while (list($k, $v) = each($keys))
{
    echo $new_input = $input[$v];
}

?>
scandar at home dot se 13-Apr-2003 09:58
Note that the int num_req parameter is the required number of element to randomly select. So if your array has 3 element and num_req=4 then array_rand() will not return anything since it is impossible to select 4 random elements out of an array that only contains 3 elements. Many people think that they will get 3 elements returned but that is of course not the case.
mickoz[at]parodius[dot]com 01-Dec-2002 08:28
For those of you thinking that it does not work for num_req = 1, it is because it return a variable and not an array.  This mainly cause some problem with people using foreach.

The correct way to handle this is explained by that example:

<?php
$some_array
= array("blah","bleh","foo","lele");

$nb_value = 1;

srand ((float) microtime() * 10000000);
$rand_keys = array_rand($some_array, $nb_value);

if(!
is_array($rand_keys))
{
 
$rand_keys = array($rand_keys);
}

print_r($rand_keys); // verify here the array of keys
echo "\n<BR>";
?>

// You can then correctly use the foreach, as it require an array to work
// If you use foreach with one element, it won't work.

<?php
$random_array
= array();

foreach(
$rand_keys as $value)
{
 
array_push($random_array, $some_array[$value]);
}

print_r($random_array);
?>
josh at 3io dot com 14-Jun-2002 03:20
I modified fake_array_rand to always only return 1 element, and did some benchmarks against calling array_rand with the second parameter as 1.  I ran 100 samples for each function for each number of elements and took the average result.  While the internal array_rand is faster for a small number of elements, it scales very poorly.

1 elements: 2.0619630813599E-05 sec. for array_rand,8.4352493286133E-05 sec. for fake_array_rand
10 elements: 2.1675825119019E-05 sec. for array_rand,8.427619934082E-05 sec. for fake_array_rand
100 elements: 2.9319524765015E-05 sec. for array_rand,8.4599256515503E-05 sec. for fake_array_rand
1000 elements: 0.0001157283782959 sec. for array_rand,8.5572004318237E-05 sec. for fake_array_rand
10000 elements: 0.0016669762134552 sec. for array_rand,8.5201263427734E-05 sec. for fake_array_rand
100000 elements: 0.015599734783173 sec. for array_rand,8.5580348968506E-05 sec. for fake_array_rand
1000000 elements: 0.18011983394623 sec. for array_rand,8.6690187454224E-05 sec. for fake_array_rand

<?php
function fake_array_rand ($array)
{
       
$count = count ($array);
       
# Help keep the number generator random :)
       
$randval and usleep ("0.$randval");

       
# Seed the random number generator
        # Generate a random number
       
srand ((double) microtime() * 10000000);
       
$randval = rand();

       
# Use the random value to 'pick' an entry from the array
        # Count the number of times that the entry is picked
       
++$index[$randval % $count];

        return
$array[$randval % $count];
}
?>
uvm at sun dot he dot net 09-Jul-2001 06:09
If you're just trying to draw a random subset of n elements from an array, it seems more effecient to do something like this:

<?php
function draw_rand_array($array,$draws)
{
       
$lastIndex = count($array) - 1;
       
$returnArr = array();
        while(
$draws > 1)
        {
               
$rndIndex = rand(0,$lastIndex);
               
array_push($returnArr,array_splice($array,$rndIndex,1));
               
$draws--;
               
$lastIndex--;
        }

        return
$returnArr;
}
?>

No messing with indexes when you're done... you just have an array with the elements you're looking for in it.