PHP重命名文件前必须检查源目录和目标目录是否可写，而非仅检查文件本身；Linux/macOS要求源目录可写，Windows要求两者均可写；推荐先用is_writable()校验双目录，再rename()，失败时fallback至copy()+unlink()并记录日志。
PHP 文件名替换前必须检查 is_writable()
直接 rename() 一个文件却没确认权限，是 PHP 中最常导致“Permission denied”错误的操作之一。Linux/macOS 下，rename() 要求**源文件所在目录可写**（不是文件本身可写），而 Windows 下则要求**源文件和目标路径所在目录都可写**。跳过 is_writable() 检查，等于把失败留给运行时。
-
is_writable()判断的是「目录是否允许创建/删除文件」，不是「文件是否可修改内容」 - 对文件路径调用
is_writable('path/to/file.txt')在某些 PHP 版本（如 8.1+）可能返回false，即使目录本身可写——应始终传入**目录路径**而非文件路径 - 如果目标文件已存在，
rename()会覆盖它，但前提是目标目录可写；若不可写，会报Warning: rename(): Permission denied
正确检查并执行文件名替换的三步流程
核心逻辑：先确认源文件存在且可读，再确认**源目录和目标目录都可写**，最后调用 rename()。不要只检查一个目录。
- 用
file_exists()和is_readable()确认源文件就位 - 用
dirname($source)和dirname($target)分别提取两个路径的目录，并各自调用is_writable() - 目标路径的父目录不存在时，
rename()必然失败——需提前用mkdir(..., 0755, true)创建完整路径
if (!file_exists($source) || !is_readable($source)) {
throw new Exception("源文件不存在或不可读: {$source}");
}
$srcDir = dirname($source);
$dstDir = dirname($target);
if (!is_writable($srcDir)) {
throw new Exception("源目录不可写: {$srcDir}");
}
if (!is_writable($dstDir)) {
if (!mkdir($dstDir, 0755, true)) {
throw new Exception("目标目录不可写且无法创建: {$dstDir}");
}
}
if (rename($source, $target)) {
echo "文件已重命名为: {$target}";
} else {
throw new Exception("rename() 失败，请检查磁盘空间、SELinux 或 NFS 挂载限制");
}
is_writable() 在 Docker / SELinux / NFS 环境下的失效场景
在容器或企业服务器上，is_writable() 可能返回 true 却仍 rename() 失败——这不是 PHP 的 bug，而是底层权限模型的限制。
- Docker 中挂载的卷（尤其是 macOS 上的
osxfs）可能让is_writable()误判，因为文件系统模拟层不完全透出 POSIX 权限 - SELinux 启用时，即使目录
chmod 777，也可能因 context（如unconfined_u:object_r:user_home_t:s0）阻止重命名操作 - NFS 共享若以
no_root_squash以外方式导出，PHP 进程 UID 在服务端无对应权限，is_writable()无法探测该层限制
替代方案：用 copy() + unlink() 绕过目录级重命名限制
当 rename() 因跨文件系统或权限策略失败时，这是唯一可靠 fallback。但它不原子，需手动处理中间状态。
立即学习“PHP免费学习笔记（深入）”；
- 先
copy($source, $target)—— 这只要源可读、目标目录可写即可 - 再
unlink($source)—— 这要求源文件所在目录可写（同rename的源目录要求） - 若
unlink()失败，说明源目录权限不足，此时已产生副本，需人工清理或加事务标记
if (copy($source, $target)) {
if (@unlink($source)) {
echo "安全替换完成";
} else {
error_log("WARN: {$source} 删除失败，已保留副本 {$target}");
}
} else {
throw new Exception("copy() 失败，无法完成替换");
}
实际项目中，rename() 是首选，但必须配合双目录 is_writable() 校验；一旦涉及容器、NFS 或高安全策略环境，就得准备好 copy()+unlink() 的兜底逻辑——而且得留日志，不然文件残留问题很难追溯。 
