| 函数 | 作用 | 返回值 | 严格模式 | 典型场景 |
|---|---|---|---|---|
| in_array() | 值是否存在 | bool | 支持 | 白名单校验、权限检查 |
| array_key_exists() | 键是否存在 | bool | 键名类型敏感 | 配置项检查、数组结构验证 |
| array_search() | 值→首个键 | key|false | 支持 | 反向查找、获取索引位置 |
| array_keys() | 获取所有键/指定值的键 | array | 值匹配支持严格 | 遍历键名、提取特定值的键集 |
| array_values() | 获取所有值并重置索引 | array | 不适用 | 重新索引、转为纯列表、JSON 编码前 |
<?php
$fruits = ['apple', 'banana', 'orange', 'pear'];
$fruit = 'apple';
if (in_array($fruit, $fruits)) {
echo "$fruit 已在数组中";
}
// 严格模式:类型也要匹配
in_array('1', [1, 2]); // true (非严格)
in_array('1', [1, 2], true); // false (严格:string !== int)
<?php
$fruit = ['apple' => 'red', 'banana' => 'yellow'];
if (array_key_exists('apple', $fruit)) {
echo "apple's color is {$fruit['apple']}"; // apple's color is red
}
// 与 isset() 区别:isset($arr['key']) 在值为 null 时返回 false
$arr = ['key' => null];
isset($arr['key']); // false
array_key_exists('key', $arr); // true
<?php
$fruits = ['apple' => 'red', 'banana' => 'yellow', 'watermelon' => 'green'];
$found = array_search('green', $fruits); // 'watermelon'
if ($found !== false) {
printf("%s was founded on %s.", $found, $fruits[$found]);
// watermelon was founded on green.
}
<?php
$fruits = ['apple' => 'red', 'banana' => 'yellow', 'watermelon' => 'green'];
// 所有键
print_r(array_keys($fruits));
// Array([0]=>apple [1]=>banana [2]=>watermelon)
// 仅获取值为 'green' 的键
print_r(array_keys($fruits, 'green')); // ['watermelon']
// 严格模式
array_keys([1, '1', 2], '1', true); // [1] 仅匹配字符串
<?php
$fruits = ['apple' => 'red', 'banana' => 'yellow', 'watermelon' => 'green'];
$values = array_values($fruits);
print_r($values);
// Array([0]=>red [1]=>yellow [2]=>green)
// 实用场景:关联数组转 JSON 数组(对象→数组)
$obj = (object)['a' => 1, 'b' => 2];
json_encode($obj); // {"a":1,"b":2} 对象
json_encode(array_values((array)$obj)); // [1,2] 数组
<?php
$data = ['id' => 1, 'name' => 'Tom', 'email' => 'tom@ex.com', 'password' => 'secret'];
$whitelist = ['id', 'name', 'email'];
// 方法 1:array_intersect_key + array_flip
$filtered = array_intersect_key($data, array_flip($whitelist));
// 方法 2:foreach + array_key_exists(更语义化)
$filtered = [];
foreach ($whitelist as $key) {
if (array_key_exists($key, $data)) {
$filtered[$key] = $data[$key];
}
}
<?php
$required = ['name', 'email', 'age'];
$input = ['name' => 'Tom', 'email' => 'tom@ex.com'];
$missing = array_diff($required, array_keys($input));
if ($missing) {
throw new Exception('缺少字段: ' . implode(', ', $missing));
}
in_array / array_search:O(n) 线性扫描,大数组慎用循环调用array_key_exists:O(1) 哈希查找,极快array_keys/values:生成新数组,内存占用翻倍,大数组考虑 Generator 迭代array_is_list() 判断是否为列表(连续数值键),配合 array_values 优化❌
if (array_search($val, $arr))—— 0 索引当 false
✅if (array_search($val, $arr) !== false)❌
isset($arr[$key])判断键存在 —— 值为 null 误判
✅array_key_exists($key, $arr)
根据查找目标(键/值)与返回需求(布尔/键/集合)选择最合适的函数,代码更简洁高效。