(PHP 8 >= 8.2.0)
Random\Randomizer::shuffleArray — 取得陣列的排列
傳回輸入 array 的均勻選擇排列。
輸入的 array 中，每種可能的排列組合都有相同的機率被回傳。
Random\Randomizer::$engine 的 Random\Engine::generate() 方法所拋出的 Throwable。
範例 #1 Random\Randomizer::shuffleArray() 範例
<?php
$r = new \Random\Randomizer();
$fruits = [ 'red' => '🍎', 'green' => '🥝', 'yellow' => '🍌', 'pink' => '🍑', 'purple' => '🍇' ];
// 洗牌陣列：
echo "水果沙拉: ", implode(', ', $r->shuffleArray($fruits)), "\n";
// 再次洗牌：
echo "另一盤水果沙拉: ", implode(', ', $r->shuffleArray($fruits)), "\n";
?>上述範例將會輸出類似以下的內容
Salad: 🍎, 🥝, 🍇, 🍌, 🍑 Another Salad: 🍑, 🍇, 🥝, 🍎, 🍌