PHP str_ends_with 怎样判断字符串后缀

在 PHP 里判断文件名、路由片段或配置值是否以某段字符串结尾，PHP 8.0 及以上可以直接使用 str_ends_with()。它的参数顺序是“待检查字符串、后缀”，返回布尔值；比较默认区分大小写，后缀传空字符串时结果为 true。

这几个边界决定了它适合做明确的后缀判断，但不能直接当成“忽略大小写的文件扩展名解析器”。下面把常用写法和容易误判的地方拆开。

str_ends_with 的参数和比较规则

haystack 是完整字符串，needle 是要匹配的后缀。只要完整字符串的末尾与后缀逐字节相同，函数就返回 true；后缀更长或大小写不同则返回 false。

这里的“区分大小写”很重要：.csv 和 .CSV 不是同一个后缀。函数本身是二进制安全的，不会替你做字符集转换、大小写折叠或路径标准化。

把文件后缀判断封装成可复用函数

如果业务约定扩展名不区分大小写，先统一双方的大小写，再调用 str_ends_with()。同时要明确空文件名是否允许，以及调用方传入空后缀时应该返回什么。

如果只需要严格匹配，保持 $ignoreCase 为 false 或直接调用原函数即可。对于文件扩展名，统一大小写只是业务选择，并不代表真实文件系统一定大小写不敏感。

版本和编码边界要提前处理

str_ends_with() 是 PHP 8.0 引入的函数。项目仍运行在 PHP 7.x 时，直接调用会导致函数不存在；这时应在兼容层提供自己的实现，或先完成运行时升级，不要在业务代码里到处散落版本判断。

另外，函数按字符串字节进行比较。英文扩展名通常没有问题；如果后缀包含中文或其他多字节字符，仍应保证输入和后缀使用同一编码，并且不要把“字符数量”误当成字节长度来推导结果。需要自然语言大小写、规范化或 Unicode 规则时，应先选用明确的字符串处理策略，再进入后缀判断。

常见问题

空后缀是不是应该返回 false？

PHP 手册定义空字符串是所有字符串的后缀，因此原函数会返回 true。如果业务上空后缀没有意义，就像示例一样在调用前显式拒绝它。

能不能用它判断“以 csv 或 json 结尾”？

不能把多个后缀放进一次调用。可以分别调用两次并用逻辑或连接，或者把允许的后缀列表逐项判断；不要把后缀列表拼成一个字符串。

为什么 .CSV 没匹配到 .csv？

因为函数大小写敏感。是否忽略大小写要由业务规则决定，统一大小写时也要考虑字符编码和文件系统语义。

总结

判断后缀时，先确认 PHP 版本，再把完整字符串和目标后缀按正确顺序传给 str_ends_with()。默认严格区分大小写，空后缀返回 true；如果业务不接受这些默认边界，就在封装层明确处理，而不是误以为函数会自动完成规范化。