PHP rename() 本身不跳过隐藏文件，需手动过滤：用 scandir() 获取文件后排除 .、.. 及以 . 开头的项，或用 glob($dir.'/*') 自动避开隐藏文件。
PHP rename() 替换文件名时如何跳过 . 开头的隐藏文件
直接用 rename() 本身不判断文件是否隐藏，必须手动过滤。Linux/macOS 下以 . 开头的文件默认为隐藏文件（Windows 无此约定，但部分脚本会沿用该规则），所以关键是在遍历前排除它们。
- 用
scandir()获取目录内容后，显式检查每个文件名是否以.开头 - 注意
.和..是特殊目录项，必须排除，否则可能引发路径错误或无限递归 - 不要依赖
filetype()或is_dir()来识别隐藏性——它们不反映隐藏属性
批量重命名时安全过滤隐藏文件的 PHP 示例
以下代码只对非隐藏的普通文件执行重命名，保留原目录结构，不触碰 .gitignore、.env 等常见隐藏文件：
$dir = '/path/to/files';
$files = scandir($dir);
foreach ($files as $file) {
$path = $dir . '/' . $file;
// 跳过 . 和 ..，以及任何以 . 开头的文件/目录
if ($file === '.' || $file === '..' || strpos($file, '.') === 0) {
continue;
}
// 只处理文件（可选：跳过子目录）
if (!is_file($path)) {
continue;
}
$newName = 'prefix_' . $file;
$newPath = $dir . '/' . $newName;
if (rename($path, $newPath)) {
echo "Renamed: $file → $newName\n";
} else {
echo "Failed to rename: $file\n";
}
}
用 glob() 更简洁地避开隐藏文件
glob() 支持通配符，且默认不匹配以 . 开头的文件（这是 shell 行为继承），比 scandir() + 手动过滤更轻量，适合简单场景：
-
glob($dir . '/*')—— 匹配非隐藏文件和子目录 -
glob($dir . '/*.*')—— 仅匹配带扩展名的非隐藏文件 - 若需严格排除子目录，加
is_file()二次判断 - 注意：
glob()在 Windows 上行为一致，但某些旧版 PHP（
rename() 失败的常见隐藏陷阱
即使跳过了隐藏文件，重命名仍可能失败，几个容易被忽略的点：
立即学习“PHP免费学习笔记（深入）”；
- 目标路径已存在同名文件，
rename()不覆盖，返回false—— 必须用file_exists()预检 - 源文件被其他进程占用（如日志文件正被写入），
rename()在 Windows 上会直接失败 - 跨文件系统移动（例如从
/tmp到/home）在 Linux 下等价于 copy+unlink，失败时不回滚 - PHP 进程没有目标目录的写权限，或父目录无执行（
x）权限（Linux 下影响路径解析）
真正麻烦的不是“怎么跳过隐藏文件”，而是重命名操作本身不具备原子性、不可逆、不报详细错误原因——出问题时得靠 error_get_last() 或 clearstatcache() 辅助排查。
