PHP shuffle() 函數詳解：數組隨機重排的核心用法、鍵名重置行為與實戰示例

函數定義

bool shuffle ( array &$array )

• **原地修改**傳入數組 (引用參數)
• **重置數字鍵名**為 0, 1, 2... (關聯鍵名**丟失**)
• 返回 true 成功 / false 失敗
• PHP 4.2.0+ 無需 srand() 播種，自動初始化

基礎示例：索引數組

$arr = range(1, 8);  // [1,2,3,4,5,6,7,8]
print_r($arr);
shuffle($arr);
print_r($arr);

輸出示例 (每次不同)：
Array ( [0]=>1 [1]=>2 [2]=>3 [3]=>4 [4]=>5 [5]=>6 [6]=>7 [7]=>8 )
Array ( [0]=>6 [1]=>1 [2]=>3 [3]=>2 [4]=>5 [5]=>7 [6]=>8 [7]=>4 )

關鍵行為：關聯數組鍵名丟失

$arr = ["a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5];
shuffle($arr);
print_r($arr);

輸出：
Array ( [0]=>5 [1]=>2 [2]=>1 [3]=>3 [4]=>4 )
// 原鍵名 a,b,c,d,e 全部丟失，重置為 0-4

實戰應用場景

常見誤區與避坑指南

1. 誤以為保持鍵名：關聯數組使用 shuffle 會丟失鍵名 → 使用 shuffle_assoc() (見上篇文章)
2. 多維數組直接 shuffle：僅打亂頂層順序，子數組內部順序不變 → 使用遞歸方案
3. 期望加密級隨機：shuffle 使用 Mersenne Twister，**不適合加密用途** → 使用 random_int() / openssl_random_pseudo_bytes()
4. PHP 7.1 前需手動播種：舊版本需 srand((float)microtime() * 1000000) → 升級 PHP 或統一入口播種

性能特徵

• 時間複雜度：O(n) - Fisher-Yates 洗牌算法
• 空間複雜度：O(1) - 原地交換
• 比 array_rand() + 循環取值更快、代碼更簡潔

擴展：保持鍵名的隨機取樣

function array_random(array $array, int $count): array {
    $keys = array_keys($array);
    $selectedKeys = array_rand(array_flip($keys), min($count, count($keys)));
    $selectedKeys = (array)$selectedKeys;  // array_rand 可能返回單值
    return array_intersect_key($array, array_flip($selectedKeys));
}

// 使用
$randomItems = array_random($assocArray, 3);  // 保持原鍵名

總結

shuffle() 是 PHP 數組隨機化的核心函數，特點是**原地修改、重置數字鍵名、O(n) 性能**。理解其「鍵名丟失」行為至關重要。關聯數組、多維數組、加密場景需使用替代方案。實際開發中常配合 array_slice() 實現隨機取樣。