PHP strpbrk 找不到字符时怎样区分false与空字符串

PHP 的 strpbrk() 找不到字符时返回的是布尔值 false，不是空字符串。找到字符时，它返回从第一个匹配字符开始的剩余字符串，所以判断失败必须使用 === false。如果用宽松比较，返回内容为 "0" 或其他看起来像空值的字符串，就可能把“找到了”误判成“没找到”。

官方地址：https://www.php.net/manual/en/function.strpbrk.php

结论：把 strpbrk($text, $characters) 的结果保存下来，再用 $result === false 判断未匹配；不要用 empty()、!$result 或 == false 代替严格比较。

• 找到：返回从匹配位置开始的字符串，例如 "-paid"。
• 找不到：返回布尔值 false。
• 字符集为空：PHP 8 及以上抛出 ValueError，不再按普通未匹配处理。

strpbrk 找到字符时返回的不是匹配位置

strpbrk() 的第二个参数是一组候选字符，函数会从左到右寻找其中任意一个字符。成功时返回值不是偏移量，也不是只返回一个字符，而是从命中字符开始一直到字符串末尾的片段。下面的代码用 === false 把返回字符串和失败值分开。

为什么不能用 empty 或宽松比较判断失败

PHP 的字符串在条件表达式里有自己的真假规则。尤其是字符串 "0" 会被当成假值，因此 !$result 和 empty($result) 不适合表达“函数是否返回了 false”。== false 也会进行类型转换，可能让成功返回的特殊字符串与 false 混在一起。

这个例子里第一个字符就是候选字符，返回的字符串可能以 0 开头。即使某个字符串在布尔上下文中表现为假，它也仍然是字符串；严格比较只关心返回值的类型和值是否真的等于布尔 false。

空字符集、大小写和位置需求要单独处理

$characters 不是普通的完整子串，而是“任意一个候选字符”的集合，匹配区分大小写。例如 "S" 不会匹配小写 "s"。第二个参数传空字符串时，PHP 8 及以上会抛出 ValueError，这不是“找不到字符返回 false”的分支。

如果业务真正需要的是第一个候选字符的偏移量，而不是命中后的剩余字符串，可以考虑 strcspn()。它直接返回遇到候选字符之前的长度；但如果字符串为空或候选集合为空，仍应先按对应函数的参数契约处理。

常见问题

strpbrk 找不到字符会返回空字符串吗？

不会。按照 PHP 手册，找不到时返回 false；找到时返回从命中字符开始的字符串，不能把空字符串当成它的标准失败值。

为什么推荐 === false？

因为它不会把字符串先转换成布尔值。这样可以清楚区分“返回了字符串”和“返回了布尔 false”，也能避开字符串 "0" 的特殊真假规则。

第二个参数传空字符串该怎么办？

调用前先检查候选字符集。PHP 8 及以上会对空字符集抛出 ValueError，应将它当作参数错误处理，而不是当作一次普通的未匹配。