17370845950

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() 失败的常见隐藏陷阱

即使跳过了隐藏文件，重命名仍可能失败，几个容易被忽略的点：

• 目标路径已存在同名文件，rename() 不覆盖，返回 false —— 必须用 file_exists() 预检
• 源文件被其他进程占用（如日志文件正被写入），rename() 在 Windows 上会直接失败
• 跨文件系统移动（例如从 /tmp 到 /home）在 Linux 下等价于 copy+unlink，失败时不回滚
• PHP 进程没有目标目录的写权限，或父目录无执行（x）权限（Linux 下影响路径解析）

真正麻烦的不是“怎么跳过隐藏文件”，而是重命名操作本身不具备原子性、不可逆、不报详细错误原因——出问题时得靠 error_get_last() 或 clearstatcache() 辅助排查。