5.7

New addDirectory(string $name) method for adding empty directories to zip.

5.6

What's Changed

• Suppress headers when saving to disk by @jszobody in #130

Full Changelog: 5.5...5.6

5.5

What's Changed

• S3File: use dedicated temp stream to get size by @bayprogrammer in #126

New Contributors

• @bayprogrammer made their first contribution in #126

Full Changelog: 5.4...5.5

5.4

What's Changed

• Laravel 12.x Compatibility

Full Changelog: 5.3...5.4

5.3

What's Changed

• Fix S3 filenames that include a hash by @cyreb7 in #121

New Contributors

• @cyreb7 made their first contribution in #121

Full Changelog: 5.2.1...5.3

Conflict handling

Conflict handling

If two or more files are added to the zip with the same zip path, you can use ZIPSTREAM_CONFLICT_STRATEGY to configure how the conflict is handled:

• ZIPSTREAM_CONFLICT_STRATEGY=skip: Keep the initial file, skip adding the conflicting file (default)
• ZIPSTREAM_CONFLICT_STRATEGY=replace: Keep the latest file, overwrite previous files at the same path
• ZIPSTREAM_CONFLICT_STRATEGY=rename: Append a number to the conflicting file name, e.g. file.txt becomes file_1.txt

Note: filenames are compared case-insensitive. FILE.txt and file.TXT are considered conflicting. If you are working only on a case-sensitive filesystem you can set ZIPSTREAM_CASE_INSENSITIVE_CONFLICTS=false. Don't do this if you have Windows users opening your zips!

Version 5.0

Version 5 is a major refactor of this package based on ZipStream 3.1. 🎉

Breaking changes

1. The config file has been rearranged a bit. If you published the config file you'll need to do that again.
2. STS\ZipStream\ZipStream is now STS\ZipStream\Builder. You may need to update some typehints in your code.
3. STS\ZipStream\ZipStreamFacade is now STS\ZipStream\Facades\Zip. The global Zip alias is still registered.
4. ENV ZIPSTREAM_FILE_METHOD is now ZIPSTREAM_COMPRESSION_METHOD
5. ENV ZIPSTREAM_FILE_SANITIZE is now ZIPSTREAM_ASCII_FILENAMES

Other changes

1. All zips are Zip64 now as they are widely supported.
2. We flush zip output right away. This reduces buffering and memory usage, and gets zip output to the user started as quickly as possible.
3. Header X-Accel-Buffering: no is added for nginx. See here.

New features

1. $zip->has($path) to check if a file already was added
2. $zip->addFromDisk($diskName, $source, $zipPath) to add files using a Laravel storage disk
3. $zip->saveToDisk($diskName, $folder) to save output to a Laravel storage disk
4. $zip->then(function() { // do something after zip is finished sending }); to handle any cleanup or other post-zipping tasks
5. $zip->setComment(...) for adding comments to the main zip file
6. $file->setComment(...) for individual file comments (you have to use File::make yourself to have access to the file instance and use this)

5.0-beta.1

Added:

• $zip->has($path) to check if a file already was added
• $zip->addFromDisk($diskName, $source, $zipPath) to add files using a Laravel storage disk
• $zip->saveToDisk($diskName, $folder) to save output to a Laravel storage disk
• $zip->then(function() { // do something after zip is finished sending });
• Uses $flushOutput to minimize zip buffering and RAM usage and get zip output faster to user

5.0-beta

This is a major refactor based on ZipStream 3.1.

A few backwards compatible breaks:

1. STS\ZipStream\ZipStream is now STS\ZipStream\Builder. You may need to update some typehints in your code.
2. STS\ZipStream\ZipStreamFacade is now STS\ZipStream\Facades\Zip. The global Zip alias is still registered.
3. The config file has been rearranged a bit. If you published the config file you'll need to do that again.

A few ENVs have been renamed:

1. ZIPSTREAM_FILE_METHOD => ZIPSTREAM_COMPRESSION_METHOD
2. ZIPSTREAM_FILE_SANITIZE => ZIPSTREAM_ASCII_FILENAMES

Laravel 11 support

4.14

L11