HOWTO · PHP
在 PHP 中检查数组是否包含某值
本教程演示如何使用 PHP 中的内置函数检查数组是否包含特定值。
本页内容
当问题是某个值是否与数组元素匹配时,使用 in_array()。当问题是文本是否包含数组中存储的若干字符串之一时,使用 strpos()。这两种检查回答的是不同问题:成员检查不会在数组元素内部查找子字符串,而子字符串匹配也不能证明整段文本本身就是数组中的一个值。
使用 in_array() 检查数组中的完全匹配值
in_array($needle, $haystack) 会返回布尔值,表示 $needle 是否与数组中的某个元素匹配。默认情况下,PHP 会进行松散比较,因此不同类型的值也可能被视为相等。如果值和类型都必须匹配,请将 true 作为第三个参数 $strict 传入。当数组可能同时包含数字字符串和整数时,这一点尤其有用。
运行此示例:
本节中的代码以及显示的标签或输出仍为英文。
<?php
$values = ["demo", 10];
var_dump(in_array("10", $values));
var_dump(in_array("10", $values, true));
var_dump(in_array(10, $values, true));
bool(true)
bool(false)
bool(true)
第一次调用使用默认比较方式;第二次要求严格比较;第三次则以严格比较检查整数元素。应根据数据模型预期的类型选择是否启用严格比较,不要依赖隐式类型转换。示例输出中的提示文字保持英文,与代码块中的原文一致;它们并未本地化。
在循环中使用 strpos(),查找数组值是否为文本中的子字符串
若要检查文本是否包含任意候选字符串,可遍历候选值,并调用 strpos($text, $candidate)。该函数会返回匹配位置;没有匹配时则返回 false。请用 !== false 比较结果:匹配可能从位置 0 开始,这是有效的位置,但在松散布尔判断中会被当作假值。
本节中的代码以及显示的标签或输出仍为英文。
<?php
$candidates = ['John', 'Michelle', 'Shawn'];
$text = 'Shawn is here';
$found = false;
foreach ($candidates as $candidate) {
if (strpos($text, $candidate) !== false) {
$found = true;
break;
}
}
var_dump($found);
这个循环在找到第一个匹配项后就会停止。它回答的是文本中是否至少出现了一个候选字符串,而不是数组中是否存在完全匹配的元素。如果要忽略字母大小写,请有意选择不区分大小写的搜索方式,并留意文本编码和比较规则。示例输出中的提示文字保持英文,与代码块中的原文一致;它们并未本地化。
为什么 json_encode() 不是可靠的数组搜索方式
json_encode() 会将 PHP 值转换为 JSON 字符串,而不会创建可供搜索的 PHP 对象。使用 strpos() 搜索这个序列化后的字符串时,可能会在较长的元素中匹配到子字符串:例如,搜索 John 会匹配 Johnson 这样的元素,即使任务是查找完全匹配的姓名 John。JSON 标点和转义形式描述的也是编码后的表示,而非原始值。
本节中的代码以及显示的标签或输出仍为英文。
<?php
$names = ['Johnson', 'Michelle'];
$encoded = json_encode($names);
$hasExactName = in_array('John', $names, true);
$textHasNamePart = strpos($encoded, 'John') !== false;
var_dump($hasExactName);
var_dump($textHasNamePart);
检查数组成员时,应直接检查数组并使用 in_array(),或者遍历数组值并应用所需的比较方式。只有当序列化后的文本本身就是目标输入时,才应搜索编码后的 JSON;不要用这种做法代替对原始数据的检查。示例输出中的提示文字保持英文,与代码块中的原文一致;它们并未本地化。
选择与问题相符的检查方式
使用 in_array() 检查数组元素中是否存在一个完整值;如果类型也必须匹配,请启用它的严格比较参数。使用 foreach 循环和 strpos() !== false 检查较长文本中是否出现任意候选字符串,包括从第一个字符开始的匹配。命名结果时应明确区分:一种是数组成员检查,另一种是子字符串检测。
不要通过搜索 json_encode() 的输出判断数组中是否存在完全匹配的值。序列化会改变数据表示,也会导致在较长值中匹配到子字符串。应检查原始数组中的实际元素,再根据预期类型选择松散或严格比较。这样代码表达的问题更直接,也更便于维护。