PHP Randomizer::pickArrayKeys 怎么无重复抽样键名

需要从一组带业务键名的 PHP 关联数组里随机抽取若干项，而且同一次结果不能重复时，PHP 8.2 引入的 Random\Randomizer::pickArrayKeys() 正好对应这个任务。它返回的是“键名列表”，不是值列表；方法会选出互不相同的键，返回数组还是连续索引的 list。调用时只要保证抽样数量在 1 到原数组元素数量之间，就不需要自己写循环去重。

官方地址：https://www.php.net/manual/en/random-randomizer.pickarraykeys.php

pickArrayKeys 的返回结果为什么天然无重复

这个方法属于 Random\Randomizer 的高层随机 API，签名是 pickArrayKeys(array $array, int $num): array。它在输入数组的键集合中均匀选择指定数量的不同键，因此返回结果不会出现同一个键两次。返回数组本身是 list，也就是从 0 开始连续编号的结果容器，但其中保存的元素仍然是原数组的键名。

例如原数组使用 red、green、yellow 作为键，返回值可能是 ['yellow', 'red']。这里的 0 和 1 只是结果列表的位置，不能说明原数组存在 0、1 这两个键。

抽样数量怎样设置才不会触发 ValueError

真正需要提前判断的是 $num，而不是手动检查结果是否重复。官方契约要求 1 。空数组不能抽 1 项，抽样数量也不能超过可用元素数。生产代码中可以在边界处提前返回业务错误，让异常只处理调用方漏传或类型不符合预期的情况。

 count($products)) {
        throw new InvalidArgumentException('抽样数量必须在 1 到商品数量之间');
    }

    // 方法直接保证键名互不重复，不需要循环重抽。
    return (new Randomizer())->pickArrayKeys($products, $requested);
}

这里用业务异常提前表达“请求不合法”，同时仍保留方法本身的最后一道边界保护。数组元素数量不是业务库存时，先把可抽样集合过滤好，再计算 count()，不要拿原始输入的数量代替实际候选数。

从键名取回业务值的写法

pickArrayKeys() 的用途是保留原键名语义。例如商品数组以 SKU 为键，抽样后仍要通过 SKU 回到商品对象。最清晰的做法是保留键名列表，再使用 array_map() 索引原数组：

 '苹果',
    'green' => '猕猴桃',
    'yellow' => '香蕉',
    'pink' => '桃子',
];

$keys = (new Randomizer())->pickArrayKeys($fruits, 2);

// 键名是业务标识，使用它索引原数组才能拿到对应值。
$selection = array_map(
    static fn (string $key): string => $fruits[$key],
    $keys
);

echo implode('、', $selection);

如果键名既可能是整数又可能是字符串，可以把回调参数的类型声明放宽，或在数据入口统一键名类型。不要用 array_values($fruits) 后再按随机位置取值，因为那样会丢失 SKU、颜色码等原键的业务含义。

常见问题

返回的键名顺序每次都一样吗？

不保证。抽样结果是随机的，结果顺序也不应当作为业务排序协议。需要稳定展示时，抽样后再按业务字段排序。

能不能传 0 表示不抽样？

不能。方法要求数量至少为 1；如果业务允许空结果，应在调用前直接返回空数组。

相同数组内容为什么不适合用来做严格复现？

官方文档提示，结果可能受输入数组的内部结构影响。即使两个数组比较后内容相等、随机引擎状态相同，也不要把键名结果当作跨构造方式稳定的快照。