Windows下Git仓库目录PHP删除脚本权限异常解决咨询

Windows系统中，Git克隆生成的.git目录下部分文件默认带有只读属性，而PHP的unlink()函数默认不会自动移除只读权限，导致删除失败。手动删除时资源管理器会自动处理权限，但脚本需要显式处理。以下是两种可行的解决方案，均支持在GitHub Action中运行：

方案一：修改递归删除函数，先移除只读权限 #

在删除文件前，先通过chmod()将文件权限改为可读写，再执行删除。修改后的函数如下：

function deleteDirectory($dir) {
    if (!file_exists($dir)) {
        return true;
    }

    // 处理文件：先移除只读权限再删除
    if (!is_dir($dir)) {
        // Windows下只读文件需要先调整权限
        if (substr(PHP_OS, 0, 3) === 'WIN') {
            chmod($dir, 0666); // 赋予读写权限
        }
        return unlink($dir);
    }

    foreach (scandir($dir) as $item) {
        if ($item == '.' || $item == '..') {
            continue;
        }

        $path = $dir . DIRECTORY_SEPARATOR . $item;
        if (!deleteDirectory($path)) {
            return false;
        }
    }

    // 删除目录前也确保权限可写
    if (substr(PHP_OS, 0, 3) === 'WIN') {
        chmod($dir, 0777);
    }
    return rmdir($dir);
}

deleteDirectory('path-to-repository-directory');

方案二：调用系统原生删除命令（更高效） #

跨平台判断系统，直接调用系统命令删除目录，这种方式不需要手动处理权限，系统会自动处理：

function deleteDirectory($dir) {
    if (!file_exists($dir)) {
        return true;
    }

    $dir = escapeshellarg($dir);
    if (substr(PHP_OS, 0, 3) === 'WIN') {
        // Windows使用rmdir命令，/s递归删除，/q静默模式
        $command = "rmdir /s /q $dir";
    } else {
        // Linux/Mac使用rm -rf
        $command = "rm -rf $dir";
    }

    // 执行命令并检查返回值
    exec($command, $output, $returnVar);
    return $returnVar === 0;
}

deleteDirectory('path-to-repository-directory');

GitHub Action注意事项 #

• 如果使用方案二，确保GitHub Action的Windows runner中允许执行cmd命令（默认支持）；
• PHP脚本运行时需要有足够的权限，GitHub Action的默认runner用户权限足够处理这类操作；
• 避免路径中包含特殊字符，使用escapeshellarg()转义路径防止命令注入。

内容的提问来源于stack exchange，提问作者train_fox