php rename() 替换文件名需确保源目标路径存在且可写，不自动创建目录，中文名需统一utf-8编码并规避windows权限、占用及跨卷限制，推荐先校验再操作。
PHP rename() 替换文件名的基本写法
直接用 rename() 函数就能完成文件名替换，但必须确保源路径和目标路径都存在且权限正确。它不自动创建父目录，也不处理中文编码问题。
- 源文件和目标文件路径必须是完整路径（相对或绝对），不能只传文件名
- 目标目录需已存在，否则
rename()返回false并报错Warning: rename(): No such file or directory - 若目标文件已存在，Linux 下会被静默覆盖；Windows 下默认失败（除非开启
overwrite选项，但 PHP 原生rename()不支持该参数） - 操作前后建议用
file_exists()和is_writable()检查
if (file_exists('/path/old_文件.txt') && is_writable(dirname('/path/new_文件.txt'))) {
$result = rename('/path/old_文件.txt', '/path/new_文件.txt');
if (!$result) {
error_log('rename failed: ' . error_get_last()['message']);
}
}
PHP 处理含中文文件名时的编码陷阱
PHP 文件系统函数（包括 rename()、file_exists()、scandir()）底层调用的是操作系统 API，对 UTF-8 编码的中文文件名在不同环境表现不一致：Linux 通常没问题，Windows 默认使用 GBK/GB2312，会导致乱码或找不到文件。
- Web 服务器（如 Apache/Nginx）和 PHP 运行环境的 locale 设置会影响文件名解析，但 PHP 本身不自动转码
-
mb_convert_encoding()或iconv()不能直接用于路径字符串——它们可能把 UTF-8 转成 GBK 字节序列，但 PHP 函数仍按原始字节传给系统，结果不可控 - 最稳妥做法：确保整个链路统一用 UTF-8，并确认 OS 层支持（Linux 默认 OK；Windows 需设置控制台/终端为 UTF-8，且 PHP 进程启动时 locale 为
Chinese_China.65001或类似） - 简单验证方式：用
var_dump(bin2hex($filename));看实际字节流是否与磁盘中一致
安全替换中文文件名的推荐流程
绕过编码争议的务实做法：不依赖中文文件名参与逻辑，而是用英文 ID + 数据库映射。但若必须保留中文名，需加一层防御性处理。
- 先用
mb_strlen($name, 'UTF-8') > 0确认字符串是合法 UTF-8，避免二进制污染 - 过滤掉 NUL、
/、、控制字符等危险字节：preg_replace('/[ - \\/?:*|"\^]/u', '_', $name) - 长度限制建议 ≤ 200 字符（NTFS/FAT32 有路径总长限制，Linux ext4 单文件名上限 255 字节）
- 生成目标路径前，用
dirname()+mkdir(..., 0755, true)确保上级目录存在
$safe_name = preg_replace('/[ - \\/?<>:*|"\^]/u', '_', $original_name);
$safe_name = mb_substr($safe_name, 0, 200, 'UTF-8') . '.txt';
$target = __DIR__ . '/uploads/' . $safe_name;
$dir = dirname($target);
if (!is_dir($dir)) {
mkdir($dir, 0755, true);
}
rename($source, $target);
Windows 下 rename() 失败的典型原因和对策
在 Windows 上，rename() 对中文路径失败，八成不是编码问题，而是文件被占用或权限卡死。
立即学习“PHP免费学习笔记（深入）”；
- 检查文件是否被其他进程打开（如记事本、Excel、杀毒软件实时扫描）——可尝试用
lsof（WSL）或 Process Explorer 查找句柄 - 确认 PHP 进程运行账户（如 IIS 的
IIS_IUSRS，Apache 的SYSTEM）对目标目录有“修改”权限，不只是“读取” - 避免跨分区重命名（如从
C:到D:），rename()在 Windows 上本质是 move，跨卷会失败，需改用copy()+unlink() - 临时方案：用
exec('cmd /c ren "' . escapeshellarg($old) . '" "' . escapeshellarg($new) . '"')，但注意 shell 注入风险，仅限可信输入
ls -la 或 dir /u 看一眼真实字节，比猜编码更可靠。 
