Major Release 3

[maennchen]

EDIT: v3 has been released. If you face any issues, please open issues instead of commenting here.

🎉 We've just released the new major version 3 (beta).

News

• Requires PHP >= 8.1 (Version 2 will be supported until PHP 8.0 is no longer maintained)
• Extensively uses new PHP Features
  • Named Arguments
  • Enums
• The code was rewritten to simplify maintenance. Hopefully, that will lead to more people being able to contribute to the project.
• Supports to create of empty directories

Upgrade Instructions

https://github.com/maennchen/ZipStream-PHP/tree/3.0.0-beta.2#upgrade-to-version-300

Feedback

Plese try out the beta and let us know if you are facing issues / suggested improvements in the discussion.

Please be aware that this is a pre-release. Do not use it in production yet and the final release could still contain breaking changes based on the received feedback.

[NicolasCARPi]

Hello @maennchen.

It's great that you found the time to do a refactor 🎉

I finally was able to take the time to test this new release, and as far as I can tell, it seems to work fine!

Basically, my diff looks like this:

-        $opt = new ArchiveOptions();
-        // crucial option for a stream output
-        $opt->setZeroHeader(true);
-        return new ZipStream(null, $opt);
+        return new ZipStream(sendHttpHeaders:false);

Using named arguments is a good idea.

I suggest you go ahead and publish the final 3.0.0.

Best,
~Nico

[NicolasCARPi]

Ah, I realize the main branch doesn't have final already. All good.

[NicolasCARPi]

I also want to finalize #241 before I go ahead

I would propose to go ahead right now and leave that non-critical feature for 3.1. It doesn't look like it'll break everything anyway. I'm suggesting this to avoid 3.0 going into limbo because of this artificial blocker ;)

[maennchen]

@NicolasCARPi Might be a good idea as well...
I'll think about it :)

[maennchen]

@NicolasCARPi Released 👍

[NicolasCARPi]

way ahead of you: elabftw/elabftw#4164 ;)