You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sebastian Meyer 7e431406f7 Handle POST requests 1 month ago
Classes Check for timestamp granularity 1 month ago
Configuration Rename configuration template 1 year ago
Data/oai_dc Rename example record 3 years ago
Resources Clean up 3 years ago Update code of conduct to version 2.0 3 years ago Add Contribution Guidelines 5 years ago
LICENSE Add new license file 2 years ago Update documentation 1 year ago
composer.json Create composer package 3 years ago
index.php Handle POST requests 1 month ago
update.php Add summary to update.php 1 year ago

Simple OAI-PMH 2.0 Data Provider

This is a stand-alone and easy to install data provider implementing the Open Archives Initiative's Protocol for Metadata Harvesting (OAI-PMH). It serves records in any metadata format from directories of XML files using the directory name as metadataPrefix, the filename as identifier and the filemtime as datestamp. 0-byte files are considered deleted records and handled accordingly. Resumption tokens are managed using files. Sets are currently not supported.

Just put the records as XML files in the data directory, adjust a few configuration settings and you are ready to go!

A demo installation can be found here.

Codacy Badge


  1. Run composer create-project opencultureconsulting/oai_pmh <path>.

  2. Create a data directory in a not publicly accessible location outside of <path>. Create a subdirectory inside the specified data directory for every format (i. e. metadataPrefix) you want to provide.

  3. Copy Configuration/Main.template.php to Configuration/Main.php and adjust the settings according to your preferences. Don't forget pointing $config['dataDirectory'] to your newly created data directory.

  4. Put the records into the respective directories according to their format. Each record has to be a separate XML file with its identifier as filename (e. g. the file 12345678.xml can be adressed using the identifier 12345678). Optionally you can maintain deletions by keeping 0-byte files for deleted records.

  5. Congratulations! Now you are running your own Simple OAI-PMH 2.0 Data Provider. You can access the entry point by calling index.php?verb=Identify in your browser.


  1. Backup Configuration/Main.php!

  2. Delete <path> and re-install by running composer create-project opencultureconsulting/oai_pmh <path>.

  3. Move your configuration back into Configuration/Main.php.

  4. Congratulations! Now you are running the newest version of the Simple OAI-PMH 2.0 Data Provider. You can access the entry point by calling index.php?verb=Identify in your browser.


Updating your records is just as easy with the update.php script! The script automatically handles deletions by maintaining 0-byte files for deleted records. Just call php update.php from the command line and follow the instructions. (Of course, you can simply replace the records manually as well.)


This project was originally initiated in 2002 by Heinrich Stamerjohanns at University of Oldenburg. His latest implementation can still be found via the Internet Archive's Wayback Machine.

It was then modified in 2011 by Jianfeng Li at University of Adelaide for The Plant Accelerator. The modified version can be found in the Google Code Archive.

In 2013 Daniel Neis Araujo at Federal University of Santa Catarina modified the project again in order to integrate it with Moodle. His implementation can be found on GitHub. In 2014 Kazimierz Pietruszewski provided some further bugfixes.

The current implementation was derived from the latter in 2017 by Sebastian Meyer at Open Culture Consulting for the German Literature Archive. It is a stand-alone version focused on easy deployment and file based record handling.