pathinfo() 是最稳妥的取后缀方式,专为路径解析设计,能正确处理 archive.tar.gz、.gitignore、config. 等边界情况,返回纯后缀(不含点),推荐搭配 is_string() 校验和大小写归一化使用。

用 pathinfo() 取文件名后缀最稳妥
PHP 里取后缀,pathinfo() 是官方推荐方式,它专为路径解析设计,能正确处理带点的文件名(比如 archive.tar.gz)、空后缀、隐藏文件(.gitignore)等边界情况。
常见错误是直接用 strrchr() 或 substr(strrpos()),结果遇到 config. 或 .env 就出错——前者返回空字符串,后者可能误判为无后缀。
-
pathinfo($filename, PATHINFO_EXTENSION)返回纯后缀(不含点),对readme.md返回md,对.gitignore返回空字符串 - 如果要兼容「无后缀但以点结尾」的情况(如
log.),需额外判断:if ($filename !== '' && $filename[-1] === '.') { /* 视为无后缀 */ } - 注意:传入非字符串会触发警告,建议先
is_string($filename)校验
substr(strrpos()) 手动截取容易漏掉边界
手动找最后一个点再截取,代码看似短,但逻辑漏洞多。典型错误写法:substr($filename, strrpos($filename, '.')) —— 这会连点一起返回,且 strrpos() 在没找到点时返回 false,导致 substr() 报 Warning。
使用场景有限:仅当你明确知道输入格式干净(如固定为 name.ext),且不关心异常路径时才考虑。
立即学习“PHP免费学习笔记(深入)”;
- 必须检查
strrpos()返回值:$pos = strrpos($filename, '.'); $ext = $pos !== false ? substr($filename, $pos + 1) : ''; - 无法区分
a.b.c和.c:两者都返回c,但语义不同(多级扩展名 vs 隐藏文件) - Windows 路径中的反斜杠
不影响,但若混用/和,仍建议先用str_replace(['/', '\'], '/', $filename)归一化
别用 explode() 按点分割取最后一段
看到“取最后部分”,有人本能用 explode('.', $filename)[count(explode('.', $filename)) - 1] —— 这不仅性能差(重复调用 explode()),更会在 file.name.txt 上返回 txt(看似对),但在 .htaccess 上返回空数组最后一项(Notice),在 archive.tar.gz 上返回 gz(而非预期的 tar.gz)。
除非你明确只要「最后一个点之后的内容」,且接受所有歧义,否则别这么干。
- 性能上:一次
explode()已生成完整数组,再count()又遍历一遍,比strrpos()多至少一倍开销 - 安全上:未校验数组长度,
end(explode('.', $filename))在空字符串或全点字符串(如...)下返回false - 可读性差:别人一眼看不出你在取后缀,得逐层推导
后缀大小写和多级扩展名怎么处理
真实项目中,后缀常涉及大小写归一(如统一转小写存数据库)或识别复合后缀(.tar.gz)。PHP 原生函数不自动处理这些,得自己加逻辑。
比如用户上传 IMAGE.JPG,你存成 image.jpg;又比如要区分 .min.js 和 .js,就不能只看最后一个点。
- 大小写:用
strtolower(pathinfo($filename, PATHINFO_EXTENSION)) - 多级后缀:先用
pathinfo()得基础后缀,再结合白名单判断,例如in_array(strtolower($ext), ['tar.gz', 'tar.bz2']) - 注意:
pathinfo()对script.min.js返回js,不是min.js—— 它按路径规则解析,不是按“常见后缀列表”匹配
事情说清了就结束。真正难的不是写哪一行代码,而是想清楚你要的“后缀”到底指什么:是操作系统认的扩展名?还是用户直觉里的“点后面那段”?还是 CDN 缓存策略依赖的类型标识?定义模糊,后面全是坑。











