Laravel7+PHP7.4通过SFTP删除目录失败问题求助

可能原因 #

• Laravel 7默认依赖的league/flysystem-sftp 1.x版本存在目录删除逻辑缺陷，导致方法返回true但未实际执行删除操作
• Laravel封装的deleteDirectory()对SFTP目录的状态判断有误，或未正确触发底层SFTP的删除指令
• 目标目录可能残留隐藏系统文件（如.DS_Store、Thumbs.db），虽然你删除了可见文件，但这些文件阻止了目录删除（概率较低，可排查）

解决方法 #

1. 升级SFTP适配器版本 #

Laravel 7配套的league/flysystem-sftp旧版本存在已知bug，执行以下命令升级到该分支的最新稳定版：

composer require league/flysystem-sftp:^1.0.23

升级后重新测试deleteDirectory()即可。

2. 直接调用底层SFTP命令删除 #

如果升级无效，绕过Laravel的封装，直接使用SFTP原生rmdir方法操作：

$disk = Storage::disk('sftp');
$targetDir = 'your/target/directory';

// 先清理目录内所有文件和子目录（若已清理可跳过）
foreach ($disk->allFiles($targetDir) as $file) {
    $disk->delete($file);
}
foreach ($disk->allDirectories($targetDir) as $subDir) {
    $disk->getDriver()->getAdapter()->getConnection()->rmdir($subDir);
}

// 删除目标目录
$deleteResult = $disk->getDriver()->getAdapter()->getConnection()->rmdir($targetDir);

var_dump($deleteResult); // 查看实际执行结果

3. 检查目录特殊属性 #

登录服务器，检查目录是否被设置了不可修改属性：

lsattr /path/to/your/directory

如果输出包含i标记，执行以下命令解除锁定：

chattr -i /path/to/your/directory

4. 自定义递归删除函数 #

编写递归函数确保彻底清理所有内容后再删除目录：

function deleteSftpDir(\Illuminate\Contracts\Filesystem\Filesystem $disk, string $dir)
{
    if (!$disk->exists($dir)) return true;

    // 删除所有文件（含隐藏文件）
    foreach ($disk->files($dir, true) as $file) {
        $disk->delete($file);
    }

    // 递归删除子目录
    foreach ($disk->directories($dir, true) as $subDir) {
        deleteSftpDir($disk, $subDir);
    }

    // 调用底层SFTP命令删除空目录
    return $disk->getDriver()->getAdapter()->getConnection()->rmdir($dir);
}

// 使用示例
$disk = Storage::disk('sftp');
deleteSftpDir($disk, 'path/to/target/directory');

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