Improve Winter\Storm\Filesystem\Zip error reporting

Package targeted

Storm Library

Description

The wrapper around the standard ZipArchive utility doesn't return a proper error code in case of a failure when extracting the archive. It only returns false which hides the underlying reason for the failure. One can argue whether it's a good approach or not to be verbose. On one hand the intended use cases may not need to know about what exactly happened, on the other hand there may be more clients of the wrapper who don't want to reinvent the wheel or extend the class (although it's not marked as final).

There's a compromise for this particular situation. All the existing clients only check for the response to not be a false one, which can be easily converted to a check like === true without breaking anything and giving other clients an option to see the root cause of the failure.

Will this change be backwards-compatible?

Yes, based on the known usages of the class.

Start by locating the Winter\Storm\Filesystem\Zip wrapper and its archive-extraction method, then inspect the existing usages that check for false. Confirm how ZipArchive exposes extraction failures and verify that successful extraction remains distinguishable from a failure while preserving the underlying error information.