php 8.1 中 strpos('hello', '') 返回 0，php 7.4 则触发 e_warning 并返回 false；需在调用前显式拦截 $needle === '' 并统一返回 true，避免版本语义分裂。
PHP 8.1 和 7.4 中 strpos() 对空字符串 '' 的处理差异
PHP 8.0 起，strpos() 正式支持空字符串作为 $needle，并明确定义行为：当 $needle === '' 时，始终返回 0（因为“空串在任意位置都可视为存在”，且按规范定义为起始位置）。PHP 7.4 不支持该行为——传入空字符串会触发 E_WARNING 并返回 false。
这意味着同一段代码在两个版本中可能产生完全相反的判断结果：
-
strpos('hello', '')→ PHP 7.4 返回false，PHP 8.1 返回0 - 若你写
if (strpos($str, '') !== false)，PHP 8.1 进入分支，PHP 7.4 跳过 - 若你漏判空值、直接用
if (strpos(...))，两边都会错，但错法不同：7.4 因警告+false 被跳过，8.1 因 0 被跳过
为什么不能只靠 !== false 就万事大吉
仅加固判断逻辑不够，因为 strpos() 在空字符串输入上的语义已分裂。PHP 8.1 把它当作合法输入并返回位置，PHP 7.4 当作非法输入并报错+返回 false。这种差异不是“松散比较”能掩盖的，而是函数契约本身变了。
所以封装层必须主动拦截空 $needle，统一语义：
- 显式检查
$needle === ''，直接返回true（按业务语义，空串应视为“总是包含”） - 不依赖
strpos()自身对空串的处理，避免版本分叉 - 这个判断必须放在类型转换之后、调用
strpos()之前，否则 PHP 7.4 会在(string) null后得到''，再传给strpos()触发警告
实际项目中容易被忽略的触发点
空字符串很少是手写的 ''，更多来自动态来源，比如：
- 数据库字段为
NULL，经(string) $row['tag']转成'' - API 请求参数未传，
$_GET['q'] ?? ''得到空串 - 配置项默认值设为空字符串，如
$config['delimiter'] = '' - 用户表单提交了空文本框，
$_POST['search']是''
这些在 PHP 7.4 下可能静默失败（警告被忽略），但在 PHP 8.1 下变成“逻辑成立”，导致搜索条件意外命中、权限绕过或缓存键计算错误。
封装时怎么写才真正跨版本安全
核心是三步：兜空值、转字符串、再调用。不要把兼容逻辑分散在各处，而是在入口统一收口：
function str_contains_safe($haystack, $needle): bool
{
$haystack = (string) ($haystack ?? '');
$needle = (string) ($needle ?? '');
if ($needle === '') {
return true;
}
return strpos($haystack, $needle) !== false;
}
注意两点：
- 空值判断
=== ''必须在(string)转换之后，否则null或false转成字符串后不是空串 - 不调用
mb_strpos()时无需检测扩展，但一旦加多字节支持，就必须在空值判断后做function_exists('mb_strpos')检查，否则 PHP 7.4 下会 fatal
最易被跳过的细节：PHP 8.1 对 strpos($haystack, '') 返回 0 是确定行为，但如果你在封装里忘了先判空，又用了 mb_strpos()，而 mb_strpos('', '', 0, 'UTF-8') 在某些旧 mbstring 版本下仍可能出错——所以空值拦截这一步，永远放在最外层。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
