在PHP开发过程中，经常需要对上传的文件、本地存储的文件进行重命名操作，很多时候我们只需要替换文件名的主名称部分，而保留原有的扩展名，比如把test.jpg重命名为new_test.jpg，这时候就需要掌握正确的文件名替换方法。
核心实现思路
要实现替换文件名同时保留扩展名，核心步骤可以分为三步：首先拆分原文件名，得到主名称和扩展名两部分；然后对主名称进行替换操作；最后将替换后的主名称和扩展名重新拼接成新的文件名。PHP提供了多个内置函数可以辅助完成这些操作。
具体实现方法
方法一：使用pathinfo函数拆分
pathinfo函数可以返回文件路径的信息，包括目录名、文件名、扩展名等，非常适合用来拆分文件名和扩展名。
<?php
/**
* 替换文件名主名称并保留扩展名
* @param string $originalName 原文件名
* @param string $newBaseName 新的主名称
* @return string 替换后的文件名
*/
function replaceFileNameKeepExt($originalName, $newBaseName) {
// 获取路径信息
$pathInfo = pathinfo($originalName);
// 如果没有扩展名，直接返回新的主名称
if (!isset($pathInfo['extension'])) {
return $newBaseName;
}
// 拼接新的文件名，保留扩展名
return $newBaseName . '.' . $pathInfo['extension'];
}
// 测试示例
$original = 'test_document.pdf';
$newBase = 'new_report';
$result = replaceFileNameKeepExt($original, $newBase);
echo $result; // 输出 new_report.pdf
?>
方法二：使用explode函数拆分
如果文件名中只包含一个点作为扩展名分隔符，也可以使用explode函数按点拆分字符串来实现。
<?php
function replaceFileNameByExplode($originalName, $newBaseName) {
// 按点拆分文件名
$parts = explode('.', $originalName);
// 如果拆分后只有一部分，说明没有扩展名
if (count($parts) == 1) {
return $newBaseName;
}
// 最后一部分是扩展名，前面的部分合并为主名称
$ext = array_pop($parts);
return $newBaseName . '.' . $ext;
}
// 测试示例
$original = 'image_001.png';
$newBase = 'avatar';
$result = replaceFileNameByExplode($original, $newBase);
echo $result; // 输出 avatar.png
?>
需要注意的细节
- 如果原文件名包含多个点，比如
my.file.name.txt，使用explode方法会把最后一个点之后的内容作为扩展名，pathinfo函数默认也是取最后一个点之后的内容作为扩展名，符合大多数场景的需求。 - 如果原文件没有扩展名，两种方法都会直接返回新的主名称，不会额外添加点。
- 如果文件名包含路径，比如
/uploads/2024/test.jpg，pathinfo函数会自动处理路径部分，返回的filename是不带路径的文件名，扩展名也会正确提取，而explode方法需要先处理路径，否则会把路径中的点也作为拆分依据。 - 替换主名称时如果需要支持正则替换，可以结合
str_replace或者preg_replace函数先处理主名称部分，再进行拼接。
实际应用场景示例
比如在文件上传时，为了避免文件名冲突，需要生成唯一的文件名同时保留原扩展名：
<?php
// 上传文件时生成唯一文件名并保留扩展名
$uploadedFileName = $_FILES['file']['name'];
$pathInfo = pathinfo($uploadedFileName);
// 生成唯一的主名称，比如用时间戳加随机数
$uniqueBaseName = time() . '_' . mt_rand(1000, 9999);
// 拼接新文件名
if (isset($pathInfo['extension'])) {
$newFileName = $uniqueBaseName . '.' . $pathInfo['extension'];
} else {
$newFileName = $uniqueBaseName;
}
echo $newFileName; // 输出类似 1715678900_5678.jpg
?>
通过以上方法，就可以稳定实现PHP文件名替换并保留扩展名的需求，在实际开发中可以根据具体场景选择合适的实现方式。