UnifiedArchive - an archive manager with a unified way for different formats. Supports all basic (listing, reading, extracting and creation) and specific features (compression level, password-protection). Bundled with console program for working with archives.

Fixed:

• Fixed opening an archive with password (#37)
• Fixed UnifiedArchive->getComment() now returns null when comment is not supported by driver (#39)
• Fixed UnifiedArchive->getFileData()->modificationTime is integer timestamp now in case of NelexaZip driver instead of DateTimeImmutable (#38)
• Fixed PharData::create for zip-archives

Deprecations:

• Renamed methods of UnifiedArchive:
  • getFileNames => getFiles
  • extractFiles => extract
  • addFiles => add
  • deleteFiles => delete
  • archiveFiles => archive
  • canOpenArchive => canOpen
  • Old methods are marked as deprecated and will be deleted in future releases.
• Marked as deprecated:
  • UnifiedArchive::detectArchiveType - use Formats::detectArchiveFormat instead
  • UnifiedArchive::archiveDirectory/archiveFile - use UnifiedArchive::archive instead
  • UnifiedArchive::canCreateType - Formats::canCreate

New functions:

• Added method to get file extension for format: Formats::getFormatExtension($archiveFormat)
• Added method to get info about ready to archive files: UnifiedArchive->prepareForArchiving($fileOrFiles, $archiveName = null)
• Added method to create archive in memory: UnifiedArchive::createInString() and BasicDriver::CREATE_IN_STRING ability constant
• Added new pure driver for Zip/Tar(gz/bz2) - SplitbrainPhpArchive.

• open does not throw an Exception, it returns null
• returned deleted methods in UnifiedArchive: canOpenArchive, canOpenType, canCreateType, getArchiveType, detectArchiveType, getFileResource, getArchiveFormat, isFileExists, getArchiveSize, countCompressedFilesSize, countUncompressedFilesSize.

BC-breaking changes:

• Changed signature: UnifiedArchive::open($filename, string|null $password = null) => UnifiedArchive::open($filename, array $abilities = [], string|null $password = null). Right now if second argument is string, it will be treated as password (for BC-compatability).

• open throws an Exception when format is not recognized or there's no driver that support requested abilities.

• addFiles/deleteFiles/getComment/setComment throws an Exception when driver does not support this ability.

• Deleted methods in UnifiedArchive: canOpenArchive, canOpenType, canCreateType, getArchiveType, detectArchiveType, getFileResource, getArchiveFormat, isFileExists, getArchiveSize, countCompressedFilesSize, countUncompressedFilesSize.

New features:

• Added passing needed abilities to UnifiedArchive::open() to select a better driver:

  use \wapmorgan\UnifiedArchive\Drivers\BasicDriver;
  
  # opens an array with driver, that supports content streaming and appending
  $archive = \wapmorgan\UnifiedArchive\UnifiedArchive::open('archive.7z', [BasicDriver::STREAM_CONTENT, BasicDriver::APPEND]);
  # if not specified, uses OPEN or OPEN_ENCRYPTED check, if password passed
  

• Added UnifiedArchive::test($files = []) (and cam files:test command) to test archive contents (compare actual control sum with stored crc32).
• More informative output in commands: system:drivers, system:formats, system:format, added command files:test.
• Added driver abilities to select better driver.

Driver changes:

• Added NelexaZip pure-PHP driver.
• Added Iso driver extraction ability.
• Added commenting-ability for SevenZip driver (via descript.ion file in archive).

New features:

• Reimplemented cam (console utility) - now it's on symfony/console and supports all features and more functions (folders, types) of UA.
• Added more detailed installation instructions (./vendor/bin/cam system:drivers) of specific drivers: AlchemyZippy, Cab, Iso, Lzma, Rar, SevenZip, TarByPear.
• Added ability to track progress of archive creation - new argument ?callable $fileProgressCallable of UnifiedArchive::archiveFiles().
• Added ability to pass few directories to be placed in one in-archive directory in archiving/appending (addFiles()/archiveFiles())

  [
      '' => ['./folder1', './folder2'],
      'README.md' => './subfolder/README.md'
  ] # Archive will have all folder1, folder2 contents in the root and README.md
  

Fixed:

• Fixed extract() and listContent() and their result of PclZip interface (UnifiedArchive::getPclZipInterface()) to correspond to original library (object => array).
• Added tests on archiving, extraction and for PclZip-interface.

Format changes:

• Fixed counting of extracted files when extracting the whole archive in TarByPear, TarByPhar, Zip.
• Fixed calculation archive entry compressed size (approximately) and modification time, implemented entry content streaming in TarByPhar.

Disabled rar for SevenZip driver.

Changed format of $files in archiveFiles() and addFiles()

[
    '/var/www/log.txt',                // will be "/var/www/log.txt"
    'log2.txt' => '/var/www/log2.txt', // will be "/log2.txt"
    '/var/www/site',                   // will be "/var/www/site"
    'site2' => '/var/www/site2',       // will be "/site2"
]

Old format also works, but there can be a bad case. If you have /var/www/log2.txt and log2.txt (in current directory) and pass following:

[
'/var/www/log2.txt' => 'log2.txt',
]

it will archive log2.txt as /var/www/log2.txt in an archive (new behaviour).

New features:

• Added Formats::canStream() to check if an archive files can be streamed.
• Added ability to create archives, encrypted with password (only zip (Zip, SevenZip) and 7z (SevenZip)) - added nullable $password argument to:
  • UnifiedArchive::archiveFiles($fileOrFiles, $archiveName, $compressionLevel = BasicDriver::COMPRESSION_AVERAGE, $password = null)
  • UnifiedArchive::archiveFile($file, $archiveName, $compressionLevel = BasicDriver::COMPRESSION_AVERAGE, $password = null)
  • UnifiedArchive::archiveDirectory($directory, $archiveName, $compressionLevel = BasicDriver::COMPRESSION_AVERAGE, $password = null)
• Added UnifiedArchive->getMimeType() to get mime type of archive.
• Added UnifiedArchive->getComment() to get comment of an archive. Available only in Zip and Rar drivers, others return null.
• Added UnifiedArchive->setComment(?string $comment) to set comment. Available only in Zip.
• Added filter in UnifiedArcihve->getFileNames(). If works as fnmatch() does.
• Added ability to iterate over archive and access files data as array:

$a = \wapmorgan\UnifiedArchive\UnifiedArchive::open('tests/archives/fixtures.7z');
foreach ($a as $file => $data) {
    echo $file.PHP_EOL;
 }

$file_data = $a['filename'];

Fixed:

• Fixed SevenZip driver: disabled tar.gz, tar.bzip2 support as it isn't supported properly and described which formats driver can create, append, modify and encrypt.

Methods renamed (old exist, but marked as deprecated):

• UnifiedArchive->getArchiveFormat -> UnifiedArchive->getFormat.
• UnifiedArchive->getArchiveSize -> UnifiedArchive->getSize.
• UnifiedArchive->countCompressedFilesSize -> UnifiedArchive->getCompressedSize.
• UnifiedArchive->countUncompressedFilesSize -> UnifiedArchive->getOriginalSize.
• UnifiedArchive->getFileResource -> UnifiedArchive->getFileStream.
• UnifiedArchive->isFileExists -> UnifiedArchive->hasFile.

Fixed calculation of tar's uncompressed size opened via TarByPear driver. Fixed working with tar.xz archives.

Removed extra binaries file from package

New features:

• Added ability to open archives encrypted with password - added $password argument to UnifiedArchive::open($fileName, $password = null). Works only with: zip, rar, 7z.
• Added ability to adjust compression level for new archives - added $compressionLevel argument (with default BasicDriver::COMPRESSION_AVERAGE level) to:
  • UnifiedArchive->archiveFiles($fileOrFiles, $archiveName, $compressionLevel = BasicDriver::COMPRESSION_AVERAGE)
  • UnifiedArchive->archiveFile($file, $archiveName, $compressionLevel = BasicDriver::COMPRESSION_AVERAGE)
  • UnifiedArchive->archiveDirectory($file, $archiveName, $compressionLevel = BasicDriver::COMPRESSION_AVERAGE) Works only with: zip, gzip.
• Added ability to append the archive with a file from string - added addFileFromString method: UnifiedArchive->addFileFromString(string $inArchiveName, string $content).
• Added tests for format support:
  • Formats::canOpen()
  • Formats::canCreate()
  • Formats::canAppend() - check if file can be added to an archive
  • Formats::canUpdate() - check if archive member can be removed
  • Formats::canEncrypt() - check if encrypted archive can be opened

Format changes:

• Extended SevenZip driver: now it supports a lot of formats (7z, zip, rar, iso, tar and so on).
• Added AlchemyZippy driver: it works via command-line programs for zip, tar, tar.gz and tar.bz2.

Methods renamed:

• UnifiedArchive::canOpenType -> Formats::canOpen
• UnifiedArchive::canOpenArchive -> UnifiedArchive::canOpen
• UnifiedArchive::canCreateType -> Formats::canCreate
• UnifiedArchive->getArchiveType -> UnifiedArchive->getArchiveFormat

Old methods exist, but marked as deprecated.

• Improved extendable for all classes - used late-static binding everywhere.

Format specific:

• gzip: improved detection of archive by content.

That's first production-ready release!

Format specific:

• tar:
  • Fixed automatic opening of .tar.Z and .tar.xz.
• rar:
  • Exclude directories from files list.

BC-breaking changes:

• Deleted deprecated UnifiedArchive methods: extractNode, archiveNodes.
• All mutable methods throws exceptions on errors now:
  • getFileData, getFileContent, getFileResource throws NonExistentArchiveFileException when file is not present in archive.
  • extractFiles throws:
    • EmptyFileListException
    • ArchiveExtractionException
  • deleteFiles, addFiles, addFile and addDirectory throws:
    • EmptyFileListException
    • UnsupportedOperationException
    • ArchiveModificationException
  • archiveFiles, archiveFile and archiveDirectory throws:
    • FileAlreadyExistsException
    • EmptyFileListException
    • UnsupportedOperationException
    • ArchiveCreationException
• Functionality of preparing files list for archiving is moved from archiveFiles() to prepareForArchiving().

BC-breaking changes:

• Minimal version is 5.5.0.

Format specific:

• zip: Fixed PclZip-interface
• 7zip: Fixed 7z-archiving, when archiving files should be renamed in archive
• lzw: Fixed check for availability (#15)

New features:

• Added canCreateType(): bool
• Added canAddFiles(): bool
• Added canDeleteFiles(): bool

BC-breaking changes:

• PclZip-interface getter renamed to getPclZipInterface().
• Make addFiles() return number of added files instead of total files number.

Other changes:

• Make addFiles() / deleteFiles() / archiveFiles() throw \Exceptions when any error occurred (and even when files list is empty).
• Fixed usage of / always as directory separator in addFiles() and archiveFiles().

Format-specific changes:

• Divided format-specific code into separate components.
• zip:
  • Excluded directories from files list (getFileNames()).
  • Fixed retrieving new list of files after addFiles() usage.
  • (#11) Fixed invalid "/" archive entry after archiveFiles() usage.
• tar (TarArchive adapter):
  • Fixed number of added files of addFiles().
  • Fixed list of files after deleteFiles() usage.
  • Added checks for compressed tar's support in canOpenArchive() and canOpenType().
• tar (PharData adapter):
  • Fixed list of files after addFiles()/deleteFiles() usage and path generation of archive in archiveFiles().
  • Fixed path of files in getFileNames() to use UNIX path separator ("/").
• iso:
  • Excluded directories from files list (getFileNames()).
• 7zip:
  • Fixed result of deleteFiles() and archiveFiles() in-archive paths.
  • Fixed calculation of compressed file size in getFileData().
  • (#10) Set infinite timeout of 7z system call (useful for big archives).
• cab:
  • Fixed extractFiles() functionality.

Important API changes:

• Changed algorithm of files list generation in archiveFiles() and addFiles():

  // 1. one file
  $archive->archiveFiles('/var/www/site/abc.log', 'archive.zip'); // => stored as 'abc.log'
  // 2. directory
  $archive->archiveFiles('/var/www/site/runtime/logs', 'archive.zip'); // => directory content stored in archive root
  // 3. list
  $archive->archiveFiles([
        '/var/www/site/abc.log' => 'abc.log', // stored as 'abc.log'
        '/var/www/site/abc.log', // stored as '/var/www/site/abc.log'
        '/var/www/site/runtime/logs' => 'logs', // directory content stored in 'logs' dir
        '/var/www/site/runtime/logs', // stored as '/var/www/site/runtime/logs'
  ], 'archive.zip');
  

• Disabled paths expanding in extractFiles() and deleteFiles() by default.

  If you need to expand src/ path to all files within this directory in archive, set second argument $expandFilesList argument to true.

  $archive->extractFiles(__DIR__, 'src/', true);
  $archive->deleteFiles('tests/', true);
  

• Added new element in archiveFiles() result in emulation mode. Now it returns an archive with 4 elements: added type element with archive type.

Fixes:

• Fixed LZW-stream (.tar.Z) wrapper (before it didn't work).
• Fixed ISO archives reading (before archive size could be calculated wrong).
• Fixed CAB archives extraction in getFileContent($file) (before it didn't work).
• Improved extraction in getFileContent($file) for RAR archives by using streams (before it did extract file in temporarily folder, read it and then delete it).

Improvements:

• Added isFileExists($file): bool method for checking if archive has a file with specific name.
• Added getFileResource($file): resource method for getting a file descriptor for reading all file content without full extraction in memory.
• Added canOpenArchive($archiveFileName): bool and canOpenType($archiveFormat): bool static methods to check if specific archive or format can be opened.
• Added detectArchiveType($fileName): string|false static method to detect (by filename or content) archive type.
• Added addFile($file, $inArchiveName = null) / addDirectory($directory, $inArchivePath = null) to add one file or one directory, archiveFile($file, $archiveName) / archiveDirectory($directory, $archiveName) to archive one file or directory.

Miscellaneous:

• Added simple tests.
• Added phar distribution.

BC notes:

• UnifiedArchive::extractNode() renamed → extractFiles(). Original method is still available with @deprecated status.
• UnifiedArchive::archiveNodes() renamed → archiveFiles(). Original method is still available with @deprecated status.
• UnifiedArchive::getFileData() now returns ArchiveEntry instead of stdClass. Original object fields are still available with @deprecated status.

Main changes:

• Added checks of archive opening status in UnifiedArchive constructor: now an Exception is throwing if archive is not readable.

• addFiles() and deleteFiles() now return false when archive is not editable.

• Some changes in archiveNodes() about handling directory names.

• Fixed archive rescan in addFiles() and deleteFiles().

• Removed example scripts (examples/).

• Code changes: added comments.

BC notes:

• UnifiedArchive::extractNode() renamed → extractFiles(). Original method is still available with @deprecated status.
• UnifiedArchive::archiveNodes() renamed → archiveFiles(). Original method is still available with @deprecated status.
• UnifiedArchive::getFileData() now returns ArchiveEntry instead of stdClass. Original object fields are still available with @deprecated status.

Main changes:

• Added checks of archive opening status in UnifiedArchive constructor: now an Exception is throwing if archive is not readable.

• addFiles() and deleteFiles() now return false when archive is not editable.

• Some changes in archiveNodes() about handling directory names.

• Fixed archive rescan in addFiles() and deleteFiles().

• Removed example scripts (examples/).

• Code changes: added comments,

• Cleaned up some old code.
• Added ext-phar adapter for .tar archives (if pear/archive_tar is not installed).

Remove docopt from requirements, add it as suggestion.

CAM merged into UnifiedArchive and now can be used without other packages: bin/cam.

Added:

• Initial support for CAB archives without extracting.

Changed:

• Handling of short names of tar archives.
• Removed external repository declaration.
• Removed die() in source code.

Fixed:

• Using ereg function on PHP >7.

Added:

• Adding files in archive.
• Deleting files from archive.

Fixed:

• Fixed discovering 7z archive number of files and creating new archive.

Added:

• Support for 7z (7zip) archives.

Added:

• Support for single-file bz2 (bzip2) and xz (lzma2) archives.

Changed:

• archive_tar is no longer a required package, now it is a suggestion.

Changed:

• UnifiedArchive released under the MIT license.

...