Laravel 外部存储磁盘ZipArchive压缩包解压生产环境报错问题求解

问题原因 #

错误码9对应PHP内置常量ZipArchive::ER_NOENT，本质是ZipArchive扩展只能操作本地文件系统的实体文件，无法直接读取非本地的外部存储资源：

• 本地环境使用local/public这类本地磁盘驱动，Storage::path()返回的是服务器本地真实路径，所以ZipArchive可以正常读取
• 生产环境使用外部存储驱动（对象存储/远程NAS等）时，Storage::path()要么返回远程访问URL，要么返回本地不存在的虚拟路径，自然会触发文件不存在的错误
• Storage::exists()走的是Laravel文件系统抽象层，适配所有驱动的存在性校验，所以会出现exists()返回true但ZipArchive读不到的矛盾情况

解决方案 #

方案1（全驱动兼容）：先拉取到本地临时目录操作 #

// 拉取远程压缩包到本地临时文件
$zipContent = Storage::get('folder/file.zip');
$tempZipPath = tempnam(sys_get_temp_dir(), 'unzip_');
file_put_contents($tempZipPath, $zipContent);

$zip = new ZipArchive;
if ($zip->open($tempZipPath) === true) {
    // 先解压到本地临时目录
    $tempExtractDir = sys_get_temp_dir() . '/extract_' . uniqid();
    mkdir($tempExtractDir);
    $zip->extractTo($tempExtractDir);
    $zip->close();

    // 批量上传解压后的文件到外部存储目标目录
    $fileIterator = new \RecursiveIteratorIterator(
        new \RecursiveDirectoryIterator($tempExtractDir, \RecursiveDirectoryIterator::SKIP_DOTS)
    );
    foreach ($fileIterator as $file) {
        $relativePath = substr($file->getRealPath(), strlen($tempExtractDir) + 1);
        Storage::putFileAs('folder', new \Illuminate\Http\File($file), $relativePath);
    }

    // 清理临时文件避免占用磁盘
    unlink($tempZipPath);
    app(\Illuminate\Filesystem\Filesystem::class)->deleteDirectory($tempExtractDir);
}

方案2（挂载场景适用） #

如果你的外部存储已经通过ossfs/s3fs/NAS挂载等方式映射到了生产服务器的本地目录，直接修改对应存储驱动的root配置为挂载后的本地真实路径即可，不需要修改原有业务代码。

快速验证方法：在生产环境打印dd(Storage::path('folder/file.zip'))，确认输出的路径是否是服务器本地真实存在的路径，即可快速定位问题。

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