本文介绍如何在 PHP 多维数组中根据关键词（如“Bits received”）进行部分匹配检索，而非仅限于完全相等的精确匹配，通过 strpos()、str_contains() 等函数实现高效、可读性强的模糊搜索逻辑。
本文介绍如何在 php 多维数组中根据关键词（如“bits received”）进行部分匹配检索，而非仅限于完全相等的精确匹配，通过 `strpos()`、`str_contains()` 等函数实现高效、可读性强的模糊搜索逻辑。
在实际开发中，我们常需从结构化数组中查找包含某关键词的条目——例如用户输入“Bits received”，期望匹配到 "name" => "banana: Bits received" 这样的项。原代码使用递归+严格相等（==）的方式，仅支持完整字符串匹配，无法满足模糊/子串检索需求。
✅ 推荐方案：使用 str_contains()（PHP 8.0+）或 strpos()
最简洁、语义清晰的方式是遍历数组并用 str_contains() 判断子串是否存在：
<?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 searchByNameContains(array $array, string $keyword): array {
$results = [];
foreach ($array as $item) {
if (isset($item['name']) && str_contains($item['name'], $keyword)) {
$results[] = $item;
}
}
return $results;
}
// 查找包含 "Bits received" 的项（即使只输入 "received" 也匹配）
$result = searchByNameContains($array, 'received');
print_r($result);
// 输出：
// Array (
// [0] => Array ( [id] => 33694 [name] => banana: Bits received )
// [1] => Array ( [id] => 33697 [name] => banana: Bits sent )
// )? 提示：str_contains($haystack, $needle) 是 PHP 8.0 引入的原生函数，返回布尔值，语义明确且无需处理 false 与 0 的歧义（相比 strpos()）。
⚠️ 兼容旧版本（PHP < 8.0）？用 strpos() 替代
若项目运行在 PHP 7.x 环境，推荐写法如下（注意严格比较 !== false）：
立即学习“PHP免费学习笔记（深入）”；
if (isset($item['name']) && strpos($item['name'], $keyword) !== false) {
$results[] = $item;
}? 进阶建议：大小写不敏感匹配
如需忽略大小写（如搜索 “bits” 匹配 “Bits”），可改用 stripos()：
if (isset($item['name']) && stripos($item['name'], $keyword) !== false) {
$results[] = $item;
}? 注意事项与最佳实践
- 避免递归遍历：原问题中的递归函数设计用于任意嵌套结构，但本例数据为扁平二维数组，直接 foreach 更高效、易维护；
- 字段存在性校验：务必用 isset($item['name']) 防止 Notice 错误；
- 性能考量：对海量数据（>10,000 条），建议迁移到数据库（如 MySQL FULLTEXT 索引）或专用搜索引擎（Elasticsearch）；
- 扩展性增强：可封装为支持多字段（'name', 'id', 'desc'）、支持正则或模糊度控制的通用搜索工具类。
综上，子字符串匹配的核心在于选择合适字符串函数 + 显式字段检查 + 清晰的业务封装。简单场景用 str_contains()，兼容旧版用 stripos()，复杂检索请交由专业搜索基础设施处理。
