安全做法是先用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']：
立即学习“PHP免费学习笔记（深入）”；
- 避免用
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() 不提供原始扩展名大小写信息，此时只能用正则从原字符串里捕获。
