萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 数组查找与搜索函数大全:in_array、array_key_exists、array_search、array_keys、array_values

五大核心函数对比速查

函数作用返回值严格模式典型场景
in_array()值是否存在bool支持白名单校验、权限检查
array_key_exists()键是否存在bool键名类型敏感配置项检查、数组结构验证
array_search()值→首个键key|false支持反向查找、获取索引位置
array_keys()获取所有键/指定值的键array值匹配支持严格遍历键名、提取特定值的键集
array_values()获取所有值并重置索引array不适用重新索引、转为纯列表、JSON 编码前

详细用法与代码示例

1. in_array() —— 值存在性检查

<?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)

2. array_key_exists() / key_exists() —— 键存在性检查

<?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

3. array_search() —— 值映射到首个键

<?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.
}

4. array_keys() —— 批量获取键名

<?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] 仅匹配字符串

5. array_values() —— 重置数值索引

<?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 迭代
  • PHP 8.1+ 可用 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)

根据查找目标(键/值)与返回需求(布尔/键/集合)选择最合适的函数,代码更简洁高效。

copyright © 萬盛學電腦網 all rights reserved