php怎么获得数组的键和值？array_keys与array_values用法教程

在php编程中，数组是最常用的数据结构之一，很多时候我们需要单独获取数组的所有键名或者所有键值，这时候不需要手动编写循环遍历数组，直接使用php内置的array_keys和array_values函数就能快速实现需求。

array_keys函数：获取数组的所有键名

array_keys函数的作用是返回数组中所有的键名，组成一个新的索引数组返回。它的基本语法如下：

<?php
/**
 * array_keys函数语法
 * @param array $array 要操作的原数组，必填参数
 * @param mixed $search_value 可选参数，如果指定该值，只会返回对应值的键名
 * @param bool $strict 可选参数，是否严格比较类型，默认false
 * @return array 返回包含所有键名的索引数组
 */
array_keys(array $array, mixed $search_value = null, bool $strict = false): array
?>

下面是几个常见的使用示例：

示例1：获取普通数组的所有键名

<?php
$user = [
    'name' => '张三',
    'age' => 25,
    'city' => '北京'
];
$keys = array_keys($user);
print_r($keys);
// 输出结果：Array ( [0] => name [1] => age [2] => city )
?>

示例2：指定search_value获取对应键名

<?php
$score = [
    '语文' => 90,
    '数学' => 85,
    '英语' => 90,
    '物理' => 88
];
// 获取所有值为90的键名
$keys = array_keys($score, 90);
print_r($keys);
// 输出结果：Array ( [0] => 语文 [1] => 英语 )
?>

示例3：严格模式下的键名获取

<?php
$arr = [
    'a' => 1,
    'b' => '1',
    'c' => 2
];
// 非严格模式，1和'1'视为相等
$keys1 = array_keys($arr, 1);
// 严格模式，1和'1'类型不同，不匹配
$keys2 = array_keys($arr, 1, true);
print_r($keys1); // 输出：Array ( [0] => a [1] => b )
print_r($keys2); // 输出：Array ( [0] => a )
?>

array_values函数：获取数组的所有键值

array_values函数的作用是返回数组中所有的值，并且会重新建立从0开始的连续数字索引，基本语法如下：

<?php
/**
 * array_values函数语法
 * @param array $array 要操作的原数组，必填参数
 * @return array 返回包含所有值且索引从0开始的数组
 */
array_values(array $array): array
?>

常见使用示例：

示例1：获取普通数组的所有键值

<?php
$user = [
    'name' => '张三',
    'age' => 25,
    'city' => '北京'
];
$values = array_values($user);
print_r($values);
// 输出结果：Array ( [0] => 张三 [1] => 25 [2] => 北京 )
?>

示例2：重置数组索引

当原数组的索引不是连续的，或者我们删除了数组中的某个元素导致索引不连续时，可以用array_values快速重置索引：

<?php
$arr = [0 => 'a', 1 => 'b', 2 => 'c'];
unset($arr[1]); // 删除索引1的元素
print_r($arr); // 输出：Array ( [0] => a [2] => c )
$newArr = array_values($arr);
print_r($newArr); // 输出：Array ( [0] => a [1] => c )
?>

两个函数的注意事项

• 两个函数都不会修改原数组，而是返回一个新的数组结果
• 如果原数组是空数组，两个函数都会返回空数组
• array_keys的search_value参数如果是null，会返回所有键名，因为null和数组中的null值匹配，如果需要判断键名对应的值是否为null，建议结合严格模式使用
• array_values返回的数组索引一定是连续的从0开始的数字，不管原数组的键名是什么类型

实际开发场景示例

比如我们需要校验用户提交的表单字段是否都在允许的字段列表中，就可以结合这两个函数实现：

<?php
// 允许的表单字段
$allowFields = ['username', 'password', 'email', 'phone'];
// 用户提交的表单数据
$postData = [
    'username' => 'test',
    'password' => '123456',
    'age' => 20 // 多余的字段
];
// 获取提交的字段键名
$postKeys = array_keys($postData);
// 计算差集，得到多余的字段
$extraFields = array_diff($postKeys, $allowFields);
if (!empty($extraFields)) {
    echo '提交的字段中存在不允许的字段：' . implode(',', $extraFields);
} else {
    echo '字段校验通过';
}
?>

phparray_keysarray_values数组键值获取修改时间：2026-07-12 12:30:24