str_ends_with()是php 8.0引入的原生函数，用于判断字符串是否以指定子串结尾，区分大小写，返回bool值；参数为string $haystack和string $needle，不支持数组（知识库中数组用法属错误描述）。
PHP str_ends_with 是什么函数？它从哪个版本开始可用？
str_ends_with 是 PHP 8.0 引入的原生字符串函数，用于判断一个字符串是否以指定子串结尾。它不区分大小写（这点和 str_ends_with 本身无关，注意：它**区分大小写**），返回 true 或 false。
低于 PHP 8.0 的环境无法直接使用——没有报错，而是会触发 Fatal error: Uncaught Error: Call to undefined function str_ends_with()。
- PHP 7.4 及更早：必须自己写函数或用
substr()+strlen()模拟 - PHP 8.0+：可直接调用，无需额外扩展或兼容层
怎么正确调用 str_ends_with？参数顺序和类型要注意什么？
函数签名是 str_ends_with(string $haystack, string|array $needle): bool。第一个参数是被检查的主字符串（$haystack），第二个是结尾目标（$needle），支持单个字符串或字符串数组。
常见错误包括传反参数、用空字符串当 $needle（会返回 true，因为所有字符串都“以空字符串结尾”）、或传入 null/int 导致类型错误。
- ✅ 正确：
str_ends_with('example.txt', '.txt')→true - ❌ 错误：
str_ends_with('.txt', 'example.txt')→false（逻辑颠倒） - ⚠️ 注意：
str_ends_with('abc', '')→true，不是 bug，是定义如此 - ✅ 数组用法：
str_ends_with('image.png', ['.jpg', '.png', '.gif'])→true
为什么有时返回 false 明明看起来“应该为 true”？常见陷阱有哪些？
最常踩的坑是忽略空白字符、编码差异和大小写。比如文件名末尾有不可见空格，或用了全角点号（．）代替英文点号（.），又或者期望不区分大小写但没做转换。
- 检查结尾是否有空格：
rtrim($filename)再传入str_ends_with - 避免大小写问题：统一转小写再判断 ——
str_ends_with(strtolower($s), '.pdf') - 不要混用 Unicode 符号：确保
$needle中的标点是 ASCII 字符（如.而非．） - 多字节字符串一般没问题，但若
$haystack是 GBK 编码且含中文，而$needle是 UTF-8 字节序列，可能因编码不一致导致失败
PHP 8.0 之前怎么安全替代 str_ends_with？
如果项目还跑在 PHP 7.x 上，别硬加 polyfill，优先用已有的内置函数组合。最可靠的是 substr() 配合 strlen()，比正则快，也比 strrpos() + strlen() 更直观。
示例兼容写法：
function safe_ends_with(string $haystack, string $needle): bool
{
if ($needle === '') {
return true;
}
$len = strlen($needle);
return strlen($haystack) >= $len && substr($haystack, -$len) === $needle;
}
这个函数行为与原生 str_ends_with 一致，且明确处理了空 $needle 场景。如果需要数组支持，再在外层加一层循环即可。
实际项目中，函数名、参数校验、以及是否允许 null 输入，往往比“能不能用”更影响稳定性。别只盯着语法糖，先理清输入来源是否可控。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
