应封装兼容层而非仅用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，但有严重缺陷：
-
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 场景下仍可能报未定义函数。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
