mishak/archive-tar

Archive TAR reader for PHP - supports gz, bz2 and files over 2 GB

Archive TAR Reader for PHP

Simple tool for reading TAR archives in PHP. Supports records with size larger then PHP_INT_MAX (slightly less then 2 GB)., _(*1)

Supports only USTAR format. This should be the most used TAR format after 1988., _(*2)

Gz and bz2 compressions are transparently supported via detection from filename extension., _(*3)

Installation

Add to your composer.json requirement "mishak/archive-tar": "dev-master"., _(*4)

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., _(*5)

$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...
}