For tar-based archives, this method decompresses the entire archive.
For Zip-based archives, this method fails with an exception.
The zlib extension must be enabled to decompress
an archive compressed with with gzip compression, and the
bzip2 extension must be
enabled in order to decompress an archive compressed with bzip2 compression.
In addition, this method automatically renames the file extension of the archive,
.tar by default.
Alternatively, a file extension may be specified with the second
parameter.
For decompressing, the default file extension
is .phar.tar.
Use this parameter to specify another file extension. Be aware
that no non-executable archives cannot contain .phar
in their filename.
Errors/Exceptions
Throws BadMethodCallException if
the zlib
extension is not available, or the bzip2 extension
is not enabled.