str_contains可替代strpos但不完全等价：前者专用于判断包含关系、语义清晰、类型严格；后者支持定位、偏移搜索、旧版兼容及多字节处理。
可以替代，但要看具体用途——str_contains专为“判断是否包含”而生，语义清晰、返回布尔值，比strpos更直接；而strpos还能告诉你“在哪儿”，功能更广。
str_contains适合什么场景
当你只需要知道“有没有”，不关心位置时，str_contains是首选：
- 判断文件名是否含点号：
str_contains($filename, '.') - 检查URL是否含特定域名：
str_contains($url, 'example.com') - 验证输入是否含敏感词或关键词（大小写敏感）
strpos不可被完全替代的场合
以下情况仍需用strpos（或stripos）：
- 需要获取子串首次出现的位置（比如截取后半段）
- 要从某偏移量开始搜索（支持第三个
$offset参数） - 需兼容PHP 7.x环境（str_contains在8.0才引入）
- 处理多字节字符（如中文）时，得用
mb_strpos()，而str_contains不支持编码指定
安全性和类型要求差异
str_contains对参数类型更严格：
立即学习“PHP免费学习笔记（深入）”；
- 两个参数都必须是字符串，传入
null、数组或对象会抛出TypeError - strpos在PHP 7中会尝试把非字符串
$needle转成ASCII码（已弃用），8.0起只接受字符串 - 实际使用时，建议先做类型校验：
is_string($haystack) && is_string($needle) ? str_contains($haystack, $needle) : false
性能与可读性对比
两者底层都做朴素匹配，性能差异可忽略；但str_contains胜在可读性：
-
if (str_contains($text, 'admin'))比if (strpos($text, 'admin') !== false)更易懂 - 少写
!== false，避免因误用!= false导致开头匹配失败的bug
