Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: fd4836b4cd

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin Install PEAR before running CI. February 21, 2012
Octocat-spinner-32 lib
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .hgignore
Octocat-spinner-32 .hgtags
Octocat-spinner-32 .travis.yml
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.mkd
Octocat-spinner-32 build.xml
Octocat-spinner-32 phpunit.xml
README.mkd

BagIt PHP

Build Status

This is a PHP implementation of the BagIt 0.96 specification

Supported Features:

  • bag compiling
  • manifest and tagmanifest generation
  • generation of tag files, bag-info.txt and bagit.txt
  • fetching remote files (fetch.txt)
  • bag validation

Installation

% git clone git://github.com/scholarslab/BagItPHP.git

Dependencies

You'll need to have these installed to use this:

Example: Creating a bag

require_once 'lib/bagit.php';

define('BASE_DIR', 'testbag');

// create a new bag at BASE_DIR
$bag = new BagIt(BASE_DIR);

// add a file; these are relative to the data directory
$bag->addFile('../phpunit.xml', 'phpunit.xml');

// update the hashes
$bag->update();

// create a tarball
$bag->package('testbag');

// the bag package will be created at ./testbag.tgz

Example: Creating an extended bag, with fetch.txt and bag-info.txt entries

require_once 'lib/bagit.php';

define('BASE_DIR', 'testbag');

// define some metadata to add to bag-info.txt
$baginfo = array('First-Tag' => 'This is the first tag value',
  'Second-Tag' => 'This is the second tag value'
);

// create a new bag at BASE_DIR
$bag = new BagIt(BASE_DIR, true, true, true, $baginfo);

// add a file; these are relative to the data directory
$bag->addFile('../phpunit.xml', 'phpunit.xml');

// add additional metadata to bag-info.txt
$bag->setBagInfoData('Third-Tag', 'This is the third tag value');

// add some entries to fetch.txt
$bag->fetch->add('http://example.com/bar.htm', 'bar.htm');
$bag->fetch->add('http://example.com/baz.htm', 'baz.htm');

// update the hashes
$bag->update();

// create a tarball
$bag->package('testbag');

// the bag package will be created at ./testbag.tgz

Example: Validating an existing bag

require_once 'lib/bagit.php';

// use an existing bag
$bag = new BagIt('test/TestBag.tgz');

// check validity
var_dump((bool)$bag->isValid());

Example: Reading a bag

require_once 'lib/bagit.php';

// use an existing bag
$bag = new BagIt('test/TestBag.tgz');

// validate the bag
$bag->validate();

// only execute if a valid bag
if(count($bag->getErrors()) == 0 {
  // retrieve remote files
  $bag->fetch->download();

  // copy files
  foreach($bag->getBagContents() as $filename) {
    copy($filename, 'final/destination/' . basename(filename));
  }
}

Feedback

We are relying on the GitHub issues tracker linked from the above for feedback. File bugs or other issues here.

Tests

The BagItPHP library includes unit tests to ensure the quality of the software. The easiest way to contribute to the project is to to let us know about andy bugs, and include a test case. Read the build.xml file more more information on running tests, the underlying report types, and packing information.

Note on Patches/Pull Requests

  • Fork the project
  • Make your feature addition/bug fix.
  • Add tests for it. This is important so we don't unintentionally break it in a future version
  • Commit
  • Send us a pull request...bonus points for topic branches.

Kudos

Thanks to everyone who's contributed to this:

Something went wrong with that request. Please try again.