str_contains()比strpos()更适合“是否包含”场景，因其直接返回布尔值，避免了strpos()返回0时与false松散比较导致的误判，语义更清晰且无需严格类型检查。
PHP 8.0+ 引入了 str_contains() 函数，专门用于判断字符串是否包含子串，它比 strpos() 更直观、更安全，**无需手动判断返回值是否为 false 或 0**。
为什么 str_contains 比 strpos 更适合“是否包含”场景
strpos() 返回的是子串首次出现的位置（整数），没找到时返回 false。但位置可能是 0（开头就匹配），而 0 == false 在松散比较下会误判：
-
❌ 错误写法（可能出错）：
if (strpos($str, 'a') == false)→ 当字符串以'a'开头时，strpos返回0，结果被当成“未找到” -
✅ 正确写法（需严格比较）：
if (strpos($str, 'a') === false)→ 必须用===避免类型混淆 -
✅ str_contains 直接返回 bool：
if (str_contains($str, 'a'))→ 语义清晰，无类型陷阱
常见替代写法对照表
以下是一些典型场景的转换方式：
-
检查是否包含：
str_contains($haystack, $needle)替代strpos($haystack, $needle) !== false -
检查是否不包含：
!str_contains($haystack, $needle)替代strpos($haystack, $needle) === false -
区分大小写？
str_contains()区分大小写；如需不区分，可用stripos($haystack, $needle) !== false，PHP 8.4+ 将新增str_contains_ci()，目前暂无内置替代
注意事项和兼容性提醒
str_contains() 是 PHP 8.0+ 原生函数，低版本不可用：
- 若需兼容 PHP if (!function_exists('str_contains')) { function str_contains($haystack, $needle) { return '' === $needle || false !== strpos($haystack, $needle); } }
-
$needle不能为空字符串（会抛出ValueError），而strpos('', '')返回0—— 这是设计上的明确限制，避免歧义 - 只支持字符串参数，不支持数组或数字自动转换，传非字符串会触发 TypeError（更早暴露问题）
实际使用建议
只要项目已升级到 PHP 8.0+，且逻辑是纯“判断存在性”，就应优先使用 str_contains()：
- 提升代码可读性：意图一目了然
- 减少出错概率：避开
==与===的坑 - 性能几乎无差异：底层实现同样高效，无需担心开销
- 配合其他新函数形成统一风格：如
str_starts_with()、str_ends_with()
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
