Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 

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"
You can’t perform that action at this time.