PHP替换文件名保留扩展名技巧详解

小伙伴们有没有觉得学习文章很有意思？有意思就对了！今天就给大家带来《PHP文件名替换保留扩展名方法详解》，以下内容将会涉及到，若是在学习中对其中部分知识点有疑问，或许看了本文就能帮到你！

安全做法是先用pathinfo()分离文件名主体和扩展名，仅对filename部分替换后拼接extension；需检查extension是否存在，多级扩展和大小写问题需额外处理。

PHP中用 pathinfo() 拆解文件名和扩展名

直接对完整文件名字符串做 str_replace() 或正则替换，极大概率会误伤扩展名（比如把 report.pdf 里的 .pdf 当成普通文本替换成 .pdx）。安全做法是先分离路径、文件名主体、扩展名三部分。

pathinfo() 是最稳妥的内置函数，它能准确识别扩展名边界（包括多级扩展如 .tar.gz 的情况，但默认只返回最后一段，需注意）：

$file = 'user_photo_v2.jpg';
$info = pathinfo($file);
// $info = [
//   'dirname' => '.',
//   'basename' => 'user_photo_v2.jpg',
//   'filename' => 'user_photo_v2',
//   'extension' => 'jpg'
// ]

关键点：$info['filename'] 就是不含扩展名的纯文件名主体，所有替换操作应只作用于它。

替换文件名主体并拼回扩展名的典型写法

拿到 $info['filename'] 后，用 str_replace()、preg_replace() 或 strtr() 处理，再手动拼接 . 和 $info['extension']：

• 避免用 basename($file, '.' . $info['extension']) 反向截取——当文件名本身含点（如 my.v2.config.json）时，basename() 的第二个参数行为不可靠
• 不要直接 substr($file, 0, -strlen('.' . $info['extension']))——扩展名为空时会出错，且未处理 pathinfo() 返回 extension 为 '' 的情况（如 README 无扩展名）
• 拼接前务必检查 isset($info['extension'])，否则可能生成 newname. 这类非法文件名

安全拼接示例：

$file = 'data_v1.csv';
$info = pathinfo($file);
$new_filename = str_replace('_v1', '_v2', $info['filename']);
$new_file = $new_filename . (isset($info['extension']) ? '.' . $info['extension'] : '');
// 结果：'data_v2.csv'

处理带路径的文件名时要注意 PATHINFO_FILENAME 标志

如果原始字符串是带目录的路径（如 /var/uploads/photo_old.png），pathinfo($path) 默认仍能正确提取 filename，但更明确的写法是传入标志位：

• pathinfo($path, PATHINFO_FILENAME) —— 只返回文件名主体，不带路径也不带扩展名
• pathinfo($path, PATHINFO_EXTENSION) —— 只返回扩展名
• 组合使用可省去数组键访问，减少 isset() 判断次数

例如：

$path = '/home/user/notes_final.txt';
$base = pathinfo($path, PATHINFO_FILENAME);     // 'notes_final'
$ext  = pathinfo($path, PATHINFO_EXTENSION);     // 'txt'
$new_path = dirname($path) . '/' . str_replace('_final', '_draft', $base) . '.' . $ext;
// '/home/user/notes_draft.txt'

特殊场景：扩展名含多个点或无扩展名的容错处理

真实业务中常遇到 archive.tar.gz 或 Dockerfile 这类名字。PHP 的 pathinfo() 默认只认最后一个点后的部分为扩展名，所以：

• pathinfo('archive.tar.gz', PATHINFO_EXTENSION) → 'gz'（不是 'tar.gz'）
• pathinfo('Dockerfile', PATHINFO_EXTENSION) → ''（空字符串）

若需支持多级扩展，得自己用正则判断（如 /\.[a-z0-9]+(\.[a-z0-9]+)*$/i），但绝大多数文件名替换场景不需要这么复杂。重点在于：替换后拼扩展名时，别假设 $info['extension'] 一定非空，也别指望它能覆盖所有压缩包命名习惯。

真正容易被忽略的是：Windows 下文件名不区分大小写，但 PHP 的 pathinfo() 在 Linux 上返回的 extension 是小写的，而实际文件系统可能存着大写扩展名（如 .JPG）。如果后续要比较或重命名，得考虑是否保留原始大小写——pathinfo() 不提供原始扩展名大小写信息，此时只能用正则从原字符串里捕获。

今天关于《PHP替换文件名保留扩展名技巧详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！