使用flysystem-ziparchive生成同名同位置Zip时内容未更新问题求助

这问题我之前也碰到过，核心原因是Flysystem的ZipArchiveAdapter在初始化时会持有原Zip文件的句柄或者缓存了文件内容——哪怕你用unlink()删除了物理文件，原来的$zipAdapter实例可能还在引用旧的资源，导致生成新Zip时并没有真正创建新文件，而是复用了之前的缓存/句柄，所以内容还是旧的。而换名称或位置时，相当于创建全新的Zip文件，避开了这个缓存/句柄问题，所以能正常生成。

解决步骤 #

1. 销毁原ZipAdapter实例并释放资源 #

在删除原Zip文件前，必须确保关闭ZipArchive的连接，销毁原适配器实例，让PHP彻底释放相关资源：

// 先关闭原ZipArchive的连接
$zipAdapter->getAdapter()->getArchive()->close();
// 销毁原适配器实例，释放资源
unset($zipAdapter);
// 再删除原Zip物理文件
unlink($zipFile);

2. 重新初始化ZipAdapter创建新Zip #

绝对不能复用原来的$zipAdapter实例，需要重新创建一个指向目标位置的适配器，这样才会操作全新的空白Zip文件：

// 重新初始化ZipArchiveAdapter，指向要生成的新Zip路径
$newZipAdapter = new Filesystem(new ZipArchiveAdapter($zipFile));

// 修正后的生成Zip方法
public function createZip($directory, $zipAdapter) {
    $localAdapter = new Filesystem(new LocalAdapter($directory));
    // 获取目录下的文件列表（过滤掉目录，只处理文件）
    $files = array_filter($localAdapter->listContents(), fn($item) => $item['type'] === 'file');
    
    foreach ($files as $file) {
        $zipAdapter->putStream($file['basename'], $localAdapter->readStream($file['path']));
    }
    
    // 写完后手动关闭Zip连接，确保资源释放
    $zipAdapter->getAdapter()->getArchive()->close();
}

3. 完整修改后的代码示例 #

// 初始化本地目录适配器
$localAdapter = new Filesystem(new LocalAdapter($directoryName));

// 解压原Zip到指定目录
unZip($directoryName, $zipFile);

// 处理原Zip适配器：关闭连接并销毁
$oldZipAdapter = new Filesystem(new ZipArchiveAdapter($zipFile));
$oldZipAdapter->getAdapter()->getArchive()->close();
unset($oldZipAdapter);

// 删除原Zip物理文件
unlink($zipFile);

// 初始化新的Zip适配器
$newZipAdapter = new Filesystem(new ZipArchiveAdapter($zipFile));

// 生成更新后的新Zip
createZip($directoryName, $newZipAdapter);

// 生成Zip的方法
function createZip($directory, $zipAdapter) {
    $localAdapter = new Filesystem(new LocalAdapter($directory));
    $files = array_filter($localAdapter->listContents(), fn($item) => $item['type'] === 'file');
    
    foreach ($files as $file) {
        $zipAdapter->putStream($file['basename'], $localAdapter->readStream($file['path']));
    }
    
    $zipAdapter->getAdapter()->getArchive()->close();
}

额外注意事项 #

• 确保你的unZip()函数也正确关闭了原Zip文件的句柄，避免残留的资源引用。
• 如果还是出现异常，可以在删除文件后调用gc_collect_cycles()强制PHP进行垃圾回收，释放未被引用的资源。
• 尽量避免混合使用Flysystem API和原生文件操作函数，除非你明确知道资源的生命周期。

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