如何在 PHP 中获取文件的后缀名_使用 pathinfo 函数快速提取-php教程-PHP中文网

pathinfo 是 PHP 中最直接可靠获取文件后缀名的方式，能天然处理多级扩展名和边界情况；而 substr(strrchr()) 易在隐藏文件、无点名、路径含多点等场景出错。

如何在 php 中获取文件的后缀名_使用 pathinfo 函数快速提取

pathinfo 是 PHP 中最直接、最可靠的方式获取文件后缀名，无需正则或字符串截取，且天然处理多级扩展名（如 .tar.gz）和边界情况（空扩展名、无点号、目录路径等）。

为什么不用 `substr(strrchr($filename, '.'), 1)`？

这种写法看似简洁，但容易在以下场景出错：

文件名以点开头但无扩展名（如 .gitignore），strrchr 返回完整字符串，substr 会截出 gitignore（错误）
文件名不含点（如 README），strrchr 返回 false，substr(false, 1) 触发警告并返回空字符串
路径含多个点但非扩展名（如 /var/log/apache2.4/error.log），只取最后一个点后内容，误判为 log 而非真实扩展名 log —— 表面碰巧对，实则逻辑脆弱

`pathinfo` 的正确调用方式与参数差异

必须显式传入 PATHINFO_EXTENSION，否则默认返回整个数组，浪费性能且易引发类型错误：

// ✅ 正确：只取扩展名，返回字符串（可能为空）
$ext = pathinfo($filename, PATHINFO_EXTENSION);

// ❌ 错误：返回关联数组，后续直接 echo 或比较会出问题
$info = pathinfo($filename); // ['dirname' => '...', 'basename' => '...', 'extension' => 'php', 'filename' => 'index']
$ext = $info['extension']; // 可行但冗余，且当文件无扩展名时 $info['extension'] 不存在，触发 notice

注意：pathinfo 对路径中的斜杠不敏感，pathinfo('a/b/c.txt', PATHINFO_EXTENSION) 和 pathinfo('c.txt', PATHINFO_EXTENSION) 结果一致。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

处理多级扩展名（如 `.tar.gz`）的常见误解

pathinfo 默认只识别最后一个点后的部分为扩展名，即 archive.tar.gz → gz。若需获取全部扩展名（如 tar.gz），它本身不支持，需额外处理：

确认需求：绝大多数场景（MIME 判断、文件类型路由）只需主扩展名（gz）
如真需完整后缀，建议用 preg_match('/\.[^./]+(?:\.[^./]+)*$/', $filename, $matches) 提取，但要小心路径末尾斜杠、隐藏文件等边界
不要强行用 pathinfo($filename, PATHINFO_FILENAME) 套娃切割——pathinfo('a.tar.gz', PATHINFO_FILENAME) 返回 a.tar，再对其调用 pathinfo 仍得 tar，无法还原 tar.gz