本文介绍如何在多维关联数组中根据字段值的子字符串（如部分关键词）高效检索匹配项，替代严格全等匹配，适用于动态搜索场景。
本文介绍如何在多维关联数组中根据字段值的子字符串（如部分关键词）高效检索匹配项，替代严格全等匹配，适用于动态搜索场景。
在 PHP 开发中，常需从结构化数组（如 API 响应或配置列表）中按关键词快速定位条目。原始代码使用递归全等匹配 ==，仅支持精确匹配（如必须输入 "banana: Bits received"），无法满足用户输入 "Bits received" 即命中目标的常见需求。
要实现子字符串模糊匹配，核心是将 === 或 == 替换为字符串包含判断。推荐使用 str_contains()（PHP 8.0+，语义清晰、安全）或 strpos()（兼容低版本）。以下是优化后的完整解决方案：
<?php $array = [
["id" => "33704", "name" => "Total apple"],
["id" => "33706", "name" => "Used apple"],
["id" => "33694", "name" => "banana: Bits received"],
["id" => "33697", "name" => "banana: Bits sent"]
];
function searchBySubstring(array $array, string $key, string $search): array
{
$results = [];
foreach ($array as $item) {
// 确保键存在且值为字符串，避免 Notice 错误
if (isset($item[$key]) && is_string($item[$key])) {
// PHP 8.0+ 推荐写法（简洁安全）
if (str_contains($item[$key], $search)) {
$results[] = $item;
}
// 兼容 PHP Array('id' => '33694', 'name' => 'banana: Bits received'))
?>
✅ 关键改进点说明：
- 去递归化：原递归函数设计用于任意嵌套，但本例为扁平二维数组，直接 foreach 更高效、易读、无栈溢出风险；
- 类型安全：显式检查 $item[$key] 是否存在且为字符串，防止 Warning；
- 大小写敏感控制：如需忽略大小写，可改用 stripos($item[$key], $search) !== false；
- 性能提示：对海量数据（>1000 条），建议迁移到数据库 LIKE 查询或 Elasticsearch 等专业检索引擎，PHP 数组遍历属 O(n) 时间复杂度，不适用于高并发实时搜索。
总结：子字符串匹配是提升用户体验的基础能力，选择 str_contains() 或 strpos() 即可快速落地；同时需根据数据规模合理评估架构升级路径——小数据用 PHP，大数据交由专业搜索服务。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
