应封装兼容层而非仅用function_exists检测,因fallback实现若未对齐PHP 8.0+的空字符串处理、二进制安全等细节会导致隐性不一致;推荐用substr+strlen模拟,确保PHP 7.4/8.0/8.3行为完全一致。

str_ends_with 是 PHP 8.0+ 原生函数,PHP 7.4 及更早版本直接调用会报 Fatal error: Call to undefined function str_ends_with()。必须封装兼容层,不能靠版本检测后动态调用。
为什么不能只用 function_exists('str_ends_with')
看似合理,但实际有坑:PHP 7.4 中该函数不存在,function_exists 返回 false,逻辑能走通;但若代码运行在 PHP 8.0+,该函数存在且行为严格(比如空字符串、二进制安全),而你封装的 fallback 实现若没对齐这些细节,就会产生隐性不一致。更关键的是——很多项目同时支持 7.4 和 8.3,部署环境混杂,靠运行时检测不如静态可预测。
推荐封装方式:用 substr + strlen 模拟
这是最轻量、最可控、也最接近原生语义的 fallback 方案,无需额外扩展依赖:
if (!function_exists('str_ends_with')) {
function str_ends_with(string $haystack, string $needle): bool
{
$hlen = strlen($haystack);
$nlen = strlen($needle);
if ($nlen === 0) {
return true;
}
if ($nlen > $hlen) {
return false;
}
return substr($haystack, -$nlen) === $needle;
}
}-
substr($haystack, -$nlen)直接取末尾片段,比strncmp或正则更直观 - 显式处理
$needle === ''→ 返回true,与 PHP 8 行为一致 - 提前判断
$nlen > $hlen,避免substr在负长度下静默返回false或空串(PHP 7.4 行为) - 不依赖
mbstring,纯字节安全,和原生函数一样可处理二进制数据
PHP 7.4 下千万别用 strrpos 或 strstr 替代
常见错误写法:strrpos($haystack, $needle) === strlen($haystack) - strlen($needle) —— 看似能 work,但有严重缺陷:
立即学习“PHP免费学习笔记(深入)”;
-
strrpos返回的是最后一次出现位置,不是“是否结尾”。若$needle在中间多次出现,结果不可靠 - 当
$needle为空时,strrpos返回false,导致逻辑崩溃(而原生函数规定空字符串始终返回true) - 性能差:需全串扫描,而
substr方案是 O(1) 长度判断 + O(n) 字符串比较 - 类型脆弱:
strrpos对非字符串$needle有隐式转换,PHP 7.4 已弃用该行为,触发E_DEPRECATED
封装后的函数在 PHP 7.4、8.0、8.3 下行为完全一致,包括空字符串、大小写敏感、二进制安全等边界情况。唯一要注意的是:别把它放进条件加载的文件里——确保所有用到的地方都能提前声明,否则某些 autoloader 场景下仍可能报未定义函数。



















