内容摘要：strpos() 是我在 PHP 里用得最多的字符串函数，没有之一。昨天排查一个订单号重复入库的问题，最后定位到就是 strpos 用反了——判断“不存在”时写成了 `if (strpos($str,

strpos() 是找字我在 PHP 里用得最多的字符串函数，没有之一。符串否存昨天排查一个订单号重复入库的找字问题，最后定位到就是符串否存 strpos 用反了——判断“不存在”时写成了 `if (strpos($str, $needle))`，结果当 needle 恰好出现在字符串开头（位置 0）时，找字条件为假，符串否存代码走了错误分支。找字

这个坑太经典了。符串否存strpos 返回的找字是 int 类型的位置索引，从 0 开始计数。符串否存如果找不到，找字返回 false。符串否存但 PHP 是找字弱类型，0 和 false 在宽松比较 `==` 下是符串否存相等的，只有用严格比较 `!==` 或 `===` 才能区分开。找字所以正确写法是：

if (strpos($haystack, $needle) !== false) {  // 存在 }

很多人觉得 strpos 慢，其实在单字节字符串里它很快，C 层直接扫描。真正慢的是你拿它去循环一万次还每次重复调用。我见过有人在一个 10 万行的 CSV 里逐行用 strpos 查关键词，跑了 8 秒。后来改成先 `implode` 成一个大字符串再查，瞬间 0.02 秒。

但 strpos 有个天生缺陷：它区分大小写。处理用户输入时，你很难保证对方输入的是“Apple”还是“apple”。这时候就得看场景——如果只是判断某个固定标识符（比如 `order_` 前缀），大小写敏感反而更安全。如果是搜索场景，建议直接上 `stripos()`，它不区分大小写，用法和 strpos 完全一样。

还有个容易被忽略的细节：strpos 检查的是“子串”，不是“字符”。如果你要判断一个字符串里是否包含某个字符（比如检查邮箱里有没有 @），用 `strpos($email, '@')` 没问题，但你要检查的是“是否存在某个字符”，更高效的方式是 `strpbrk()` 或直接 `strstr()`。不过说实话，日常开发里 strpos 已经覆盖 90% 的需求，没必要为了性能去记一堆替代函数。

真正让我觉得 strpos 不够用的时候，是处理多字节编码。比如中文判断“是否包含‘订单’”，strpos 是按字节算的，UTF-8 下“订”占 3 字节，“单”占 3 字节，strpos 返回的是字节位置，不是字符位置。如果只是判断存在与否，不影响结果，但如果你要截取子串，就会截出半个汉字。这种情况必须用 `mb_strpos()`，它支持字符偏移，但记得要先 `mb_internal_encoding('UTF-8')` 设置内部编码，否则默认可能是 ISO-8859-1。

最后说个冷门但实用的技巧。如果你想判断一个字符串是否以某个前缀开头，PHP 8.0 之前没有 `str_starts_with()`，但你可以用 `strpos($str, $prefix) === 0` 来实现。同理，判断后缀用 `substr_compare($str, $suffix, -strlen($suffix)) === 0`，或者 PHP 8.0 的 `str_ends_with()`。别嫌这些函数冷门，它们能让你少写好几行防御性代码。

回到开头那个订单号问题——修复方式很简单，把 `if (strpos(...))` 改成 `if (strpos(...) !== false)`。但真正值得反思的是，为什么这种错误会反复出现？因为 PHP 的宽松比较太“宽容”了，它让代码在 99% 的情况下能跑，却在边界条件上埋雷。写判断存在性的代码时，永远记住：strpos 返回 0 是合法的，返回 false 才是“没有”。这个认知，比记住任何 API 文档都管用。