Joomla Framework Archive Package
PHP
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
.travis/phpcs
Tests
src
.gitattributes
.gitignore
.gitmodules
.travis.yml
LICENSE
README.md
composer.json
phpunit.xml.dist

README.md

The Archive Package Build Status

Latest Stable Version Total Downloads Latest Unstable Version License

The archive package will intelligently load the correct adapter for the specified archive type. It knows how to properly handle the following archive types:

  • zip
  • tar | tgz | tbz2
  • gz | gzip
  • bz2 | bzip2

Loading files of the t* archive type will uncompress the archive using the appropriate adapter, and then extract via tar.

Requirements

  • PHP 5.3+
  • zlib extension for GZip support
  • bz2 extension for BZip2 support

Usage

$options = array('tmp_path' => '/tmp');

$archive = new Joomla\Archive\Archive($options)

$archive->extract(__DIR__ . '/archive.zip', __DIR__ . '/destination');

Overriding Adapters

If you have a custom adapter you would like to use for extracting, this package allows you to override the defaults. Just implement ExtractableInterface when creating your adapter, and then use the setAdapter method to override.


class MyZipAdapter implements \Joomla\Archive\ExtractableInterface
{
    public static function isSupported()
    {
        // Do you test
        return true;
    }

    public function extract($archive, $destination)
    {
        // Your code
    }
}

$archive = new Archive;

// You need to pass the fully qualified class name.
$archive->setAdapter('zip', '\\MyZipAdapter');

// This will use your
$archive->extract('archive.zip', 'destination');

Installation via Composer

Add "joomla/archive": "~1.0" to the require block in your composer.json and then run composer install.

{
    "require": {
        "joomla/archive": "~1.0"
    }
}

Alternatively, you can simply run the following from the command line:

composer require joomla/archive "~1.0"