本文介绍如何在 php 多维关联数组中根据关键词进行模糊匹配检索，替代严格相等判断，使如搜索“bits received”能命中包含该子串的字段值（如“banana: bits received”）。
本文介绍如何在 php 多维关联数组中根据关键词进行模糊匹配检索，替代严格相等判断，使如搜索“bits received”能命中包含该子串的字段值（如“banana: bits received”）。
在实际开发中，常需从结构化数组中按关键词快速定位数据。原始代码使用 == 进行精确匹配，导致输入 "Bits received" 无法匹配 "banana: Bits received"。要实现子字符串模糊查找，关键在于将相等判断升级为包含判断。
以下是一个健壮、可复用的搜索函数，支持多维数组遍历与指定键的模糊匹配：
<?php function searchItemBySubstring($array, $key, $substring, $caseSensitive = true) {
$results = [];
if (!is_array($array)) {
return $results;
}
foreach ($array as $item) {
// 确保当前项是关联数组且含目标键
if (is_array($item) && isset($item[$key])) {
$value = (string)$item[$key];
$found = $caseSensitive
? strpos($value, $substring) !== false
: stripos($value, $substring) !== false;
if ($found) {
$results[] = $item;
}
}
}
return $results;
}
// 示例数据
$array = [
["id" => "33704", "name" => "Total apple"],
["id" => "33706", "name" => "Used apple"],
["id" => "33694", "name" => "banana: Bits received"],
["id" => "33697", "name" => "banana: Bits sent"]
];
// 搜索包含 "Bits received" 的条目（不区分大小写）
$result = searchItemBySubstring($array, 'name', 'Bits received', false);
print_r($result);
// 输出：Array ( [0] => Array ( [id] => 33694 [name] => banana: Bits received ) )
?>
✅ 优势说明：
- 使用 stripos() 实现不区分大小写的子串查找（推荐默认启用）；
- 显式类型转换 (string) 防止非字符串值引发警告；
- 跳过非数组或缺失键的元素，提升鲁棒性；
- 不递归深入子数组（因本例为扁平二维结构），避免冗余开销；如需真正多维支持，可扩展为递归版本（但需谨慎防止性能退化）。
⚠️ 注意事项：
- strpos() / stripos() 返回 0 表示子串位于开头，因此必须用 !== false 判断；
- 若数据量极大（>1000 条），建议迁移到数据库并利用 LIKE '%keyword%' 或全文索引（如 MySQL FULLTEXT、Elasticsearch），PHP 数组遍历不具备可扩展性；
- 避免在循环中执行正则（如 preg_match）——除非需要复杂模式，否则 stripos 性能更优、更安全。
总结：对中小型配置数据或前端筛选场景，基于 stripos 的模糊搜索简洁高效；而对海量动态数据，应优先考虑专业检索方案，而非在内存中暴力遍历。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
