PHP 原生 str_contains() 不支持同时匹配多个子串，但可通过自定义函数实现“多关键词任一匹配”逻辑，提升代码复用性与可读性。
php 原生 `str_contains()` 不支持同时匹配多个子串，但可通过自定义函数实现“多关键词任一匹配”逻辑，提升代码复用性与可读性。
在实际开发中，我们常需判断一个目标字符串（$haystack）是否包含多个候选关键词（$needles）中的至少一个——例如验证用户输入是否含敏感词、检测日志中是否存在任一错误标识符，或实现简易的关键词高亮前置判断。虽然 PHP 8.0+ 提供了简洁的 str_contains()，但它仅接受单个 $needle 参数，无法原生支持数组形式的多关键词搜索。
为此，可封装一个轻量级辅助函数 str_contains_any()（推荐更具语义化的命名，优于 str_containsa）：
function str_contains_any(string $haystack, array $needles): bool
{
foreach ($needles as $needle) {
if (str_contains($haystack, $needle)) {
return true;
}
}
return false;
}✅ 使用示例：
$text = 'The quick brown fox jumped over the lazy dog'; var_dump(str_contains_any($text, ['fox', 'cow', 'goat'])); // bool(true) var_dump(str_contains_any($text, ['cat', 'elephant'])); // bool(false) var_dump(str_contains_any($text, [])); // bool(false) —— 空数组安全返回 false
⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 函数要求 $needles 为纯字符串数组；若存在非字符串元素（如 null 或数字），str_contains() 将触发类型警告（PHP 8+ 默认严格模式下可能报错），建议调用前校验或添加类型转换（如 (string)$needle）；
- 当前实现为“短路匹配”（找到首个命中项即返回 true），时间复杂度最优为 O(1)，最差为 O(n×m)，适用于中小规模关键词集；若需高性能批量匹配（如上千关键词），应考虑基于 Aho-Corasick 算法的专用库（如 symfony/string 的 UnicodeString::containsAny() 或第三方扩展）；
- 函数返回 bool，符合直觉语义；如需获取所有匹配项的具体位置或关键词本身，应另建 str_find_all_matches() 类函数。
总结：虽无原生多关键词 str_contains，但一行循环 + 短路逻辑即可优雅解决。保持函数命名清晰、输入约束明确、边界处理稳健，是构建可靠工具函数的关键。
