tsg/ar

Small lib for handling GNU ar files (i.e. .deb files)

AR archive file handling

Opening, reading and creating AR archives (like .deb files) in PHP, _(*1)

Usage

Reading

Create a reader object:, _(*2)

$ar = \Tsg\Ar\Reader::open('/path/to/file');

Get a list of files inside archive:, _(*3)

$list = $ar->ls();

This returns an array of files in format:, _(*4)

$list = [ 'filename' => [ 'fpos' => position in file, 'size' => size in bytes, 'uid' => user ID, 'gid' => group ID, 'mode' => file mode ] , ... ];

Retrieve a file's contents from inside archive:, _(*5)

$data = $ar->get('filename');

This returns the data read directly from the file as found in the ls() method above. You can directly write this data to disk using fwrite() or file_put_contents(), _(*6)

Writing

Create a writer object:, _(*7)

$ar = \Tsg\Ar\Writer::create('/path/to/file');

Add a file to it:, _(*8)

$ar->add('/path/to/file');

Or add multiple files at once using a glob:, _(*9)

$ar->add('/path/to/files/*');

Or chain add files!, _(*10)

$ar->add('1.file')->add('2.file')->add('3.file');

Then close the file, _(*11)

$ar->close();

After the file is closed, it is ready to be used as a standard ar archive. You can confirm it's been written using the ar tool., _(*12)