本文介绍如何在 php 中判断指定子字符串是否存在于数组的任意元素中，而非要求完全相等；提供可复用的函数、完整示例及关键注意事项。
在 PHP 开发中，in_array() 仅支持完全匹配（即整个字符串与数组某项严格相等），但实际业务中常需实现“模糊查找”——例如检查 "wor" 是否作为子串出现在 ["hello", "world", "!"] 的某个元素中（此时应命中 "world"）。此时需借助字符串定位函数 strpos() 配合循环遍历。
以下是一个简洁、健壮且可复用的解决方案：
function partial_array_search(array $array, string $keyword): array
{
$matches = [];
foreach ($array as $item) {
// 使用 === false 严格判断，避免 keyword="0" 时误判
if (strpos($item, $keyword) !== false) {
$matches[] = $item;
}
}
return $matches;
}
// 示例使用
$array = ["hello", "world", "!"];
$string = "wor";
$result = partial_array_search($array, $string);
if (!empty($result)) {
echo "match: ";
print_r($result); // 输出: Array ( [0] => world )
} else {
echo "not match";
}✅ 关键说明：
- strpos() 返回子串首次出现的位置（整数），未找到则返回 false；务必使用 !== false 进行严格比较，防止关键字为 "0" 或 "00" 等导致逻辑错误；
- 函数返回所有匹配项组成的数组，便于后续扩展（如统计次数、获取首个匹配项等）；若只需布尔结果，可直接 return !empty($matches);；
- 支持 UTF-8 多字节字符串？默认 strpos() 不支持中文等多字节字符；如需兼容，请改用 mb_strpos($item, $keyword, 0, 'UTF-8') 并确保 mbstring 扩展已启用。
? 进阶建议：
立即学习“PHP免费学习笔记（深入）”；
- 若数组极大且性能敏感，可考虑提前 break（仅需判断是否存在）；
- 如需忽略大小写匹配，可用 stripos() 替代 strpos()；
- 避免在循环内重复调用 strtolower() 等函数，推荐统一预处理或使用原生不区分大小写的函数。
该方法轻量、无外部依赖，适用于绝大多数子串存在性校验场景，是 in_array() 在模糊搜索场景下的自然延伸。
