array_search()是PHP中查找值对应下标的标准函数,返回首个匹配键(数字或字符串),未找到返回false;需用===判断失败,避免falsy值误判。

array_search() 是最直接的下标查找函数
要快速定位某个值在数组中的下标,array_search() 是 PHP 原生提供的标准解法。它会遍历数组,返回第一个匹配值的键名(下标),没找到则返回 false。
- 对索引数组和关联数组都有效,返回的是原始键(可能是数字或字符串)
- 默认启用松散比较(
==),若需严格匹配(类型+值),必须传入第三个参数true - 遇到重复值时只返回首个匹配项的键,不会报错也不会继续找
示例:
$arr = ['a', 'b', 'c', 'b'];
echo array_search('b', $arr); // 输出 1
echo array_search('b', $arr, true); // 同样输出 1,但类型检查更安全
用 array_keys() 找全部匹配下标(不止第一个)
当需要获取所有等于某值的下标(比如数组含重复元素),array_keys() 更合适——它支持传入搜索值,返回所有匹配键组成的数组。
- 同样支持第三个参数
true控制是否严格比较 - 返回结果是数组,即使只找到一个也会是单元素数组,使用前建议用
count()或empty()判断 - 性能上比多次调用
array_search()略优,因为只需一次遍历
示例:
$arr = [0 => 'x', 1 => 'y', 2 => 'x', 3 => 'z'];
$indices = array_keys($arr, 'x'); // 返回 [0, 2]
if (!empty($indices)) {
echo "找到位置:". implode(',', $indices);
}
立即学习“PHP免费学习笔记(深入)”;
自定义函数处理复杂条件(比如模糊匹配、对象属性)
原生函数只支持精确值匹配。如果要按正则、子串、对象字段等条件查下标,就得自己遍历。别硬套 array_search(),写个简单 foreach 更清晰可控。
- 用
foreach ($arr as $key => $value)显式取键,逻辑一目了然 - 提前
break或return可避免无谓遍历,尤其大数据量时有实际意义 - 注意不要在循环中修改数组结构(如
unset()),否则键序可能混乱,影响后续判断
示例(找包含 “test” 的字符串下标):
function findIndexBySubstring($arr, $substr) {
foreach ($arr as $key => $value) {
if (is_string($value) && strpos($value, $substr) !== false) {
return $key;
}
}
return false;
}
echo findIndexBySubstring(['hello', 'test123', 'world'], 'test'); // 输出 1
注意 key 类型和 false 返回值的陷阱
array_search() 和 array_keys() 在没找到时都返回空数组或 false,但 false 在松散比较下容易误判——比如目标值本身是 0、'' 或 null,而返回 0(合法下标)会被 if ($result) 当成假值跳过。
- 务必用
=== false判断失败,而不是== false或直接if (!$result) - 如果数组键本身可能是
0、false、null等“falsy”值,更要警惕比较方式 - 对关联数组,别假设键一定是数字;打印调试时用
var_dump()而非echo,避免类型隐式转换干扰判断
常见翻车写法:if (array_search('x', $arr)) { ... } —— 这会在找到下标 0 时意外跳过。











