array_keys()直接返回数组所有键名组成的索引数组,支持数字和字符串键,可选参数实现值筛选与严格比较,但不递归处理多维数组。

怎么用 array_keys() 获取数组下标集合
PHP 中最直接的方式就是调用 array_keys(),它原生返回数组所有键(即下标)组成的索引数组。无论键是数字还是字符串,只要存在,就会被提取出来。
常见错误:有人误以为 array_keys() 只返回数字索引,其实它对关联数组同样有效——比如 ['name' => 'Tom', 'age' => 25] 会返回 ['name', 'age']。
- 若只传入一个参数(源数组),返回全部键名
- 可选第二个参数
$search_value,只返回值匹配的键(适合筛选) - 第三个参数
$strict控制是否严格比较(===),默认为false
示例:
$arr = [10 => 'a', 'x' => 'b', 20 => 'c'];
print_r(array_keys($arr)); // 输出:Array ( [0] => 10 [1] => x [2] => 20 )
数字索引数组的下标集合要特别注意空洞问题
PHP 的数字索引数组可能“不连续”,比如用 unset() 删除中间元素后,array_keys() 返回的仍是原始键,而非 0,1,2... 序列。这点容易被忽略,导致后续遍历时出错。
立即学习“PHP免费学习笔记(深入)”;
使用场景:你想把稀疏数组转成紧凑的、从 0 开始的键集合(例如用于 foreach 索引定位或 JSON 序列化时保持顺序)。
- 用
array_values()+array_keys()组合可强制重排键:array_keys(array_values($arr)) - 但注意:这会丢失原始键信息,仅适用于你真正只需要“位置序号”的情况
- 若需保留原始键映射关系,别重排,直接用
array_keys($arr)即可
如何生成指定范围的下标集合(非已有数组)
有时你并不操作现有数组,而是想“凭空”生成一组下标,比如 [0,1,2,3,4] 或 ['a','b','c']。这时不用 array_keys(),而应使用 range() 或字面量构造。
性能影响:用 range(0, 99) 比循环 for 构造快得多,且更简洁;但超大范围(如百万级)会吃内存,需评估实际需求。
- 数字序列:
range(0, $n-1)或range(1, $n) - 字母序列:
range('a', 'z')(支持单字符 ASCII 范围) - 自定义集合:
['id', 'title', 'content']—— 直接写死最清晰,别硬套函数
array_keys() 在多维数组中不递归
这是最容易踩的坑:对二维或更高维数组调用 array_keys(),只返回第一层键,不会深入子数组。比如 [['a'=>1], ['b'=>2]] 的结果是 [0,1],不是 ['a','b']。
如果你需要所有嵌套层级的键,必须手动递归或用 array_walk_recursive() 配合引用收集——但要注意键名重复覆盖问题。
- 简单递归示例:
function get_all_keys($arr, &$keys = []) {
foreach ($arr as $k => $v) {
$keys[] = $k;
if (is_array($v)) get_all_keys($v, $keys);
}
return $keys;
} - 但该方式无法区分同名键在不同层级的来源,生产环境建议加路径前缀(如
'0.a')
多数时候,你其实并不需要“所有嵌套键”,先确认业务逻辑是否真要求穿透多层——往往只处理一级就足够了。











