str_shuffle
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
str_shuffle — Randomly shuffles a string
Description
$string
): stringstr_shuffle() shuffles a string. One permutation of all possible is created.
This function does not generate cryptographically secure values, and should not be used for cryptographic purposes. If you need a cryptographically secure value, consider using random_int(), random_bytes(), or openssl_random_pseudo_bytes() instead.
Parameters
-
string
-
The input string.
Return Values
Returns the shuffled string.
Changelog
Version | Description |
---|---|
7.1.0 | The internal randomization algorithm has been changed to use the » Mersenne Twister Random Number Generator instead of the libc rand function. |
Examples
Example #1 str_shuffle() example
<?php
$str = 'abcdef';
$shuffled = str_shuffle($str);
// This will echo something like: bfdaec
echo $shuffled;
?>