PHP重命名大小写文件需分两步：先改名至随机临时名，再重命名为目标名。函数rename_case_sensitive兼容多平台，自动处理冲突并保留权限，避免直接rename失败。
PHP 本身不提供直接重命名文件并自动处理大小写冲突的跨平台机制，尤其在 Linux（区分大小写）和 Windows/macOS（不区分或宽松区分）上行为不一致——rename() 在 Linux 下对大小写敏感的文件名替换会失败，除非先删后建。
Linux 下 rename() 无法直接改大小写文件名
比如想把 index.php 改成 INDEX.PHP，执行 rename('index.php', 'INDEX.PHP') 会返回 false，且 error_get_last() 可能提示 File exists 或 Invalid argument。这是因为底层 rename(2) 系统调用在同目录下将“同一文件”按大小写重命名，被内核视为非法操作。
- 必须分两步：先用
rename()改成一个中间名（如加下划线或时间戳），再重命名为目标名 - 或者用
copy()+unlink()组合（注意权限、原子性、大文件性能） - 务必检查
file_exists()和is_writable()，避免静默失败
安全可靠的大小写重命名函数（PHP 实现）
以下函数兼容 Linux/Windows，自动处理大小写冲突，并保留原文件权限（Linux）：
function rename_case_sensitive(string $old, string $new): bool
{
if (!file_exists($old)) {
return false;
}
$dir = dirname($old);
$tmp = $dir . '/.rename_' . bin2hex(random_bytes(4)) . '_' . basename($new);
if (rename($old, $tmp) && rename($tmp, $new)) {
return true;
}
// 回滚尝试
if (file_exists($tmp)) {
@unlink($tmp);
}
return false;
}
// 使用示例
rename_case_sensitive('config.php', 'CONFIG.PHP');
- 中间临时文件名带随机段，降低命名冲突概率
- 未使用
move_uploaded_file()—— 它仅适用于上传临时文件，不适用普通重命名 - 不依赖 shell 命令（如
mv），避免 escapeshellarg 风险和环境差异
批量替换目录下所有文件名大小写（注意风险）
批量操作极易误伤，特别是当目录含软链接、特殊字符或大小写混用的同名文件时。建议先用 glob() 扫描并人工确认：
立即学习“PHP免费学习笔记（深入）”；
$files = glob('./src/*.php');
foreach ($files as $path) {
$newName = strtoupper(basename($path));
$newPath = dirname($path) . '/' . $newName;
if (strcasecmp(basename($path), $newName) !== 0) {
if (rename_case_sensitive($path, $newPath)) {
echo "✓ $path → $newPath\n";
} else {
echo "✗ failed: $path\n";
}
}
}
-
strcasecmp()判断是否真有大小写差异，避免无意义重命名 - 不要用
strtoupper()处理含中文、emoji 或 UTF-8 多字节字符的文件名——应改用mb_strtoupper($name, 'UTF-8') - Web 服务器（如 Nginx/Apache）缓存了文件路径映射，改名后需清空 OPcache（
opcache_reset()）及浏览器缓存
最易被忽略的是：Git 默认在 Windows/macOS 上不追踪大小写变更，git status 看不到 Readme.md → README.MD 的改动，必须用 git config core.ignorecase false（全局慎用）或手动 git mv -f。PHP 层面再稳，版本控制没跟上，协作就出问题。
