PHP rename() 函数直接重命名文件，要求源目标同文件系统，目标目录须存在，跨分区需copy+unlink；批量替换需分离路径与文件名操作；安全命名须过滤路径遍历与非法字符；Windows中文名需转码为CP936。
PHP rename() 函数直接重命名文件
最常用、最直接的方式就是用 rename()。它不改内容，只改路径和文件名，底层调用系统 mv 命令，速度快且原子性强。
但要注意：源路径和目标路径必须在同一个文件系统（同分区）下，否则会失败并返回 false；跨分区需先 copy() 再 unlink()。
-
rename()第二个参数是完整新路径，不只是新文件名，比如/path/to/newname.txt - 目标目录必须已存在，
rename()不会自动创建父级目录 - 如果目标文件已存在，Windows 下会失败，Linux 下默认覆盖（取决于系统配置，不可依赖）
if (!rename('/var/www/old.jpg', '/var/www/new_v2.jpg')) {
error_log('rename failed: ' . error_get_last()['message']);
}批量替换文件名中的特定字符串
用 glob() 找出匹配文件，再对每个文件名做 str_replace() 或 preg_replace()，最后调用 rename()。
关键点在于：必须从完整路径中分离出目录和文件名，仅对文件名部分操作，否则容易把路径里的斜杠或目录名也误替换了。
立即学习“PHP免费学习笔记（深入）”；
- 用
dirname($path)和basename($path)拆解路径，避免手动strrpos()截取 - 替换后要检查新文件名是否合法（不能含
/ \ : * ? " < > |等非法字符） - 建议加
file_exists($new_path)判断，防止覆盖已有文件
$files = glob('/var/log/*.log');
foreach ($files as $old) {
$dir = dirname($old);
$name = basename($old);
$new_name = str_replace('_backup', '_archive', $name);
$new = $dir . '/' . $new_name;
if (!file_exists($new)) {
rename($old, $new);
}
}安全地生成唯一新文件名（防重名+防注入）
用户上传或自动生成文件时，不能直接信任原始文件名。常见做法是丢弃原名，用时间戳+随机串+扩展名组合，或者用 md5_file() 做哈希。
重点不是“怎么拼”，而是“怎么保安全”：过滤掉所有可能用于路径遍历（如 ../）或执行（如 .php）的片段。
- 用
pathinfo($filename, PATHINFO_EXTENSION)提取扩展名，不要用substr(strrchr()) - 用
basename()过滤掉路径部分，再用preg_replace('/[^a-zA-Z0-9._-]/', '', $safe_name)清洗 - 禁止直接拼接用户输入到
rename()的目标路径中
$upload_name = $_FILES['file']['name'];
$ext = pathinfo($upload_name, PATHINFO_EXTENSION);
$safe_name = bin2hex(random_bytes(8)) . '.' . strtolower($ext);
$target = '/tmp/uploads/' . $safe_name;
if (move_uploaded_file($_FILES['file']['tmp_name'], $target)) {
// 成功
}Windows 下中文文件名 rename 失败怎么办
PHP 在 Windows 上默认用 ANSI 编码处理文件名，而现代 Windows 使用 UTF-8（实际是 UTF-16LE），导致中文路径传给系统时乱码，rename() 直接失败。
根本解法是用 mb_convert_encoding() 转成系统编码（通常是 CP936），或改用 iconv()。但更稳妥的是绕过 PHP 的文件函数，调用系统命令（仅限可信环境）。
- 确认当前脚本编码是 UTF-8（
mb_internal_encoding('UTF-8')） - 对中文路径做转码：
iconv('UTF-8', 'CP936', $path) - 若仍失败，可临时用
exec('move "' . escapeshellarg($old) . '" "' . escapeshellarg($new) . '"')（注意权限与安全性）
这个环节最容易被忽略：不是代码逻辑错，而是编码层没对齐。调试时用 var_dump(bin2hex($path)) 对比原始字节，能快速定位是不是编码问题。
