strpos找不到字符串时返回false,找到首字符在位置0时返回0,二者用==判断均为false,必须用!== false严格比较;其为字节级查找,中文/emoji等多字节字符需用mb_strpos。

strpos 返回 false 还是 0?先看这个再写判断
PHP 的 strpos 找不到字符串时返回 false,但找到的第一个字符在位置 0 时也返回 0——这两个值用 == 判断都会是 false,直接写 if (strpos($a, $b)) 会漏掉开头匹配的情况。
- 必须用严格比较:
!== false,而不是!= false或隐式布尔判断 - 常见错误写法:
if (strpos($str, 'abc'))——当'abc'出现在开头时,整个条件被跳过 - 正确写法示例:
if (strpos($str, 'abc') !== false) - 如果只关心是否包含,
str_contains()(PHP 8.0+)更安全,不涉及类型陷阱
中文、emoji、多字节字符下 strpos 会错位
strpos 是字节级查找,不是字符级。遇到 UTF-8 编码的中文、emoji 或带重音符号的字母,一个“字符”占多个字节,strpos 返回的是字节偏移,不是你直觉里的“第几个字符”。
- 例如:
strpos('??hello', 'hello')可能返回12而不是2,因为 ?? 是多个 Unicode 码点组合成的合成字符,UTF-8 编码后占 12 字节 - 需要按字符位置操作时,改用
mb_strpos($str, $needle, 0, 'UTF-8'),并确保mbstring扩展已启用 - 没开
mbstring时调用mb_strpos会报致命错误:Call to undefined function mb_strpos()
strpos 的第三个参数:从哪开始找,但不能超长
第三个参数是起始搜索位置(字节偏移),它允许跳过前 N 个字节继续查找,但传入的值不能大于被搜索字符串的总字节长度,否则直接返回 false。
- 比如:
$str = 'abc'; strpos($str, 'c', 5)→ 返回false,哪怕'c'确实存在 - 安全做法:先用
strlen($str)校验偏移量,或用max(0, min($offset, strlen($str)))截断 - 注意:这个偏移是字节偏移,不是字符偏移;配合
mb_strlen($str, 'UTF-8')使用时,要同步换成mb_strpos
替代方案选哪个?看 PHP 版本和需求
不是所有场景都该硬扛 strpos 的坑。现代 PHP 提供了更明确的选项:
立即学习“PHP免费学习笔记(深入)”;
- PHP 8.0+:优先用
str_contains($haystack, $needle)判断存在性,语义清晰、无类型歧义 - 需要位置且支持多字节:用
mb_strpos($str, $sub, 0, 'UTF-8'),记得检查扩展是否可用 - 要找最后一次出现的位置:用
strrpos(同样需!== false判断),不是strpos加循环 - 正则太重、简单查找又怕编码问题?考虑先
mb_convert_encoding($str, 'ISO-8859-1', 'UTF-8')强制单字节——但仅限确定无乱码且不需保留原始编码的临时处理
真正麻烦的从来不是函数怎么写,而是你忘了它默认不认中文,也忘了 0 === false 在松散比较里是真的成立。



















