在php中，内置的`shuffle()`函数在打乱关联数组时会丢失原有的字符串键，并将其替换为数字索引。这导致在后续操作中无法通过原始键访问数据。本文将详细介绍这一问题，并提供一个自定义函数`shuffle_assoc()`，通过先打乱键名再重构数组的方式，实现关联数组的键值保留洗牌功能，确保数据完整性和可访问性。
PHP中关联数组与shuffle()函数的问题
PHP中的数组是一种非常灵活的数据结构，可以作为有序列表（索引数组）或键值对集合（关联数组）使用。当我们需要随机化数组元素的顺序时，shuffle()函数是一个常用的工具。然而，对于关联数组，shuffle()函数的行为可能会出乎意料。
根据PHP官方文档的说明，shuffle()函数在打乱数组元素的同时，会为数组中的元素重新分配新的数字键。这意味着，如果一个数组最初是关联数组，包含字符串键，那么在经过shuffle()处理后，这些字符串键将全部丢失，并被替换为从0开始的连续整数键。
让我们通过一个具体的例子来理解这个问题。假设我们有一个包含物种名称及其对应HTML路径的关联数组：
<?php
$speciesarray = array(
"Amanita aprica" => "species/Amanita_aprica.html",
"Amanita augusta" => "species/Amanita_augusta.html",
"Amanita calyptratoides" => "species/Amanita_calyptratoides.html",
"Amanita calyptroderma" => "species/Amanita_calyptroderma.html",
"Amanita constricta" => "species/Amanita_constricta.html",
"Amanita gemmata" => "species/Amanita_gemmata.html",
"Amanita magniverrucata" => "species/Amanita_magniverrucata.html",
"Amanita muscaria" => "species/Amanita_muscaria.html",
"Amanita novinupta" => "species/Amanita_novinupta.html",
"Amanita ocreata" => "species/Amanita_ocreata.html",
"Amanita pachycolea" => "species/Amanita_pachycolea.html",
"Amanita pantherina" => "species/Amanita_pantherina.html",
"Amanita phalloides" => "species/Amanita_phalloides.html",
"Amanita porphyria" => "species/Amanita_porphyria.html",
"Amanita protecta" => "species/Amanita_protecta.html",
"Amanita pruittii" => "species/Amanita_pruittii.html",
"Amanita silvicola" => "species/Amanita_silvicola.html",
"Amanita smithiana" => "species/Amanita_smithiana.html",
"Amanita vaginata" => "species/Amanita_vaginata.html",
"Amanita velosa" => "species/Amanita_velosa.html",
"Amanita vernicoccora" => "species/Amanita_vernicoccora.html"
);
// 原始意图：打乱数组，选择前5个元素，然后获取第一个元素的原始键
shuffle($speciesarray); // 第一次打乱
$speciesarray = array_slice($speciesarray, 0, 5); // 选择前5个
reset($speciesarray);
$choice = key($speciesarray); // 获取第一个元素的键
shuffle($speciesarray); // 第二次打乱（此处再次打乱会进一步巩固键丢失）
print_r($speciesarray);
echo("<br/>");
print_r($choice);
?>预期输出（保留键名）：
立即学习“PHP免费学习笔记（深入）”；
Array ( [Amanita silvicola] => species/Amanita_silvicola.html [Amanita gemmata] => species/Amanita_gemmata.html [Amanita calyptratoides] => species/Amanita_calyptratoides.html [Amanita vaginata] => species/Amanita_vaginata.html [Amanita phalloides] => species/Amanita_phalloides.html ) Amanita silvicola
实际输出（键名丢失）：
Array ( [0] => species/Amanita_silvicola.html [1] => species/Amanita_gemmata.html [2] => species/Amanita_calyptratoides.html [3] => species/Amanita_vaginata.html [4] => species/Amanita_phalloides.html ) 0
从实际输出可以看出，shuffle()操作导致了数组键名的丢失，使得key($speciesarray)返回的是数字索引0，而不是我们期望的原始字符串键。
解决方案：保留键名的关联数组洗牌函数
为了在打乱关联数组的同时保留其原始键名，我们需要实现一个自定义的洗牌函数。其核心思想是：
- 首先，从原始关联数组中提取出所有的键名。
- 然后，对这些键名进行随机打乱。
- 最后，根据打乱后的键名顺序，重新构建一个新的关联数组。
以下是实现这一功能的shuffle_assoc()函数：
<?php
/**
* 打乱关联数组并保留其键名。
*
* @param array $array 待打乱的关联数组，通过引用传递。
* @return bool 总是返回 true。
*/
function shuffle_assoc(&$array) {
// 1. 获取数组的所有键名
$keys = array_keys($array);
// 2. 打乱键名的顺序
shuffle($keys);
// 3. 根据打乱后的键名顺序重新构建数组
$new = []; // 使用短数组语法声明新数组
foreach ($keys as $key) {
$new[$key] = $array[$key];
}
// 4. 将原数组替换为新数组
$array = $new;
return true;
}
?>shuffle_assoc()函数工作原理详解
- $keys = array_keys($array);: array_keys()函数用于获取一个数组中所有的键名，并将其作为一个新的索引数组返回。例如，如果$array是['a' => 1, 'b' => 2]，那么$keys将是['a', 'b']。
- shuffle($keys);: 对提取出的键名数组$keys执行标准的shuffle()操作。由于$keys是一个简单的索引数组，shuffle()会将其元素（即原始的键名）随机排序，但其自身的数字索引会被重置。
- foreach ($keys as $key) { $new[$key] = $array[$key]; }: 这一步是关键。我们遍历已经打乱顺序的键名数组$keys。对于每一个打乱后的键$key，我们都从原始数组$array中取出其对应的值$array[$key]，并将其赋值给新数组$new的相同键$key。这样，$new数组就包含了原始键名和值，但元素的顺序是随机的。
- $array = $new;: 最后，通过引用传递的方式，将原始的$array变量替换为新构建的$new数组。这样，调用者就可以直接使用已经被打乱且保留键名的数组了。
示例应用
现在，我们将使用shuffle_assoc()函数来修正之前的代码，以达到预期效果：
<?php
// 定义 shuffle_assoc 函数
function shuffle_assoc(&$array) {
$keys = array_keys($array);
shuffle($keys);
$new = [];
foreach ($keys as $key) {
$new[$key] = $array[$key];
}
$array = $new;
return true;
}
$speciesarray = array(
"Amanita aprica" => "species/Amanita_aprica.html",
"Amanita augusta" => "species/Amanita_augusta.html",
"Amanita calyptratoides" => "species/Amanita_calyptratoides.html",
"Amanita calyptroderma" => "species/Amanita_calyptroderma.html",
"Amanita constricta" => "species/Amanita_constricta.html",
"Amanita gemmata" => "species/Amanita_gemmata.html",
"Amanita magniverrucata" => "species/Amanita_magniverrucata.html",
"Amanita muscaria" => "species/Amanita_muscaria.html",
"Amanita novinupta" => "species/Amanita_novinupta.html",
"Amanita ocreata" => "species/Amanita_ocreata.html",
"Amanita pachycolea" => "species/Amanita_pachycolea.html",
"Amanita pantherina" => "species/Amanita_pantherina.html",
"Amanita phalloides" => "species/Amanita_phalloides.html",
"Amanita porphyria" => "species/Amanita_porphyria.html",
"Amanita protecta" => "species/Amanita_protecta.html",
"Amanita pruittii" => "species/Amanita_pruittii.html",
"Amanita silvicola" => "species/Amanita_silvicola.html",
"Amanita smithiana" => "species/Amanita_smithiana.html",
"Amanita vaginata" => "species/Amanita_vaginata.html",
"Amanita velosa" => "species/Amanita_velosa.html",
"Amanita vernicoccora" => "species/Amanita_vernicoccora.html"
);
shuffle_assoc($speciesarray); // 使用自定义函数打乱并保留键名
$speciesarray = array_slice($speciesarray, 0, 5, true); // 选择前5个，并保留键名
reset($speciesarray);
$choice = key($speciesarray); // 获取第一个元素的键
shuffle_assoc($speciesarray); // 再次打乱（如果需要），仍保留键名
/* 调试输出 */
print_r($speciesarray);
echo("<br/>");
print_r($choice);
?>修正后的输出（示例，具体键名和顺序因随机性而异）：
Array ( [Amanita velosa] => species/Amanita_velosa.html [Amanita gemmata] => species/Amanita_gemmata.html [Amanita calyptratoides] => species/Amanita_calyptratoides.html [Amanita vaginata] => species/Amanita_vaginata.html [Amanita phalloides] => species/Amanita_phalloides.html ) Amanita velosa
请注意，array_slice()函数的第三个参数设置为true（array_slice($speciesarray, 0, 5, true)）非常重要。这个参数表示在切片操作后，是否保留原始数组的键。如果设置为false或省略，array_slice()也会重新索引数组，导致键名丢失。
注意事项与总结
- 理解shuffle()的默认行为：始终记住PHP内置的shuffle()函数会重新索引数组，这对于关联数组来说通常不是期望的行为。
- 选择合适的工具：当需要打乱关联数组并保留键名时，自定义shuffle_assoc()函数是标准且有效的解决方案。
- array_slice()的键保留：在使用array_slice()截取数组时，如果需要保留原始键名，务必将第四个参数$preserve_keys设置为true。
- 引用传递：shuffle_assoc()函数通过引用传递数组（&array），这意味着它会直接修改传入的数组，而不是返回一个新数组。这与内置的shuffle()函数行为一致。
通过理解shuffle()函数的特性并应用shuffle_assoc()这样的自定义函数，开发者可以更精确地控制PHP中关联数组的随机化行为，确保数据结构在处理过程中保持完整性和可访问性。
