如何在 PHP 数组中实现子字符串模糊匹配（非完全相等）

本文介绍如何在 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() 在模糊搜索场景下的自然延伸。