mishak / archive-tar
Archive TAR reader for PHP - supports gz, bz2 and files over 2 GB
v1.1.0
2016-04-01 16:12 UTC
Requires
- php: >=5.3.0
This package is not auto-updated.
Last update: 2024-11-09 14:55:31 UTC
README
Simple tool for reading TAR archives in PHP. Supports records with size larger then PHP_INT_MAX (slightly less then 2 GB).
Supports only USTAR format. This should be the most used TAR format after 1988.
Gz and bz2 compressions are transparently supported via detection from filename extension.
Installation
Add to your composer.json
requirement "mishak/archive-tar": "dev-master"
.
Examples
List all records in archive
$filename = 'archive.tar'; $reader = new Mishak\ArchiveTar\Reader($filename); $read->setBuffer(PHP_INT_MAX); $read->setReadContents(FALSE); foreach ($reader as $record) { print_r($record); }
Print all file records with contents
$filename = 'archive.tar'; $reader = new Mishak\ArchiveTar\Reader($filename); foreach ($reader as $record) { if (in_array($record['type'], array(\Mishak\ArchiveTar\Reader::REGULAR, \Mishak\ArchiveTar\Reader::AREGULAR), TRUE)) { echo $record['filename'], "\n"; echo $record['contents'], "\n"; } }
Print all file records via function callback
This will produce exactly same output as previous example.
$filename = 'archive.tar'; $reader = new Mishak\ArchiveTar\Reader($filename); $lastRecord = NULL; $read->setReadContents(function ($record, $chunk, $left, $read) use ($lastRecord) { if (!in_array($record['type'], array(\Mishak\ArchiveTar\Reader::REGULAR, \Mishak\ArchiveTar\Reader::AREGULAR), TRUE)) { continue; } if (NULL === $lastRecord || $record['filename'] !== $lastRecord['filename']) { if (NULL !== $lastRecord) { echo "\n"; } echo $record['filename'], "\n"; } echo $chunk; if (!$left) { echo "\n"; } } }); foreach ($reader as $record) { // don't mind just walking thru... }