Download the PHP package mborko/simple-oai-pmh without Composer
On this page you can find all versions of the php package mborko/simple-oai-pmh. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mborko/simple-oai-pmh
More information about mborko/simple-oai-pmh
Files in mborko/simple-oai-pmh
Package simple-oai-pmh
Short Description This is a stand-alone and easy to install data provider implementing the Open Archives Initiative's Protocol for Metadata Harvesting (OAI-PMH).
License GPL-3.0-or-later
Homepage https://github.com/mborko/simple-oai-pmh
Informations about the package simple-oai-pmh
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 timestamp. 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.
Installation
-
Run
composer create-project opencultureconsulting/simple-oai-pmh <path>. -
Create a data directory in a location not publicly accessible (i. e. outside of
<path>). Create a subdirectory inside the specified data directory for every format (i. e.metadataPrefix) you want to provide. -
Copy
Configuration/Main.template.phptoConfiguration/Main.phpand edit the settings according to your preferences. Don't forget pointing$config['dataDirectory']to your newly created data directory. -
Put the records into the respective directories according to their format. Each record has to be a separate XML file with its
identifieras filename (e. g. the file 12345678.xml can be adressed using theidentifier12345678). Optionally you can maintain deletions by keeping 0-byte files for deleted records. - 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=Identifyin your browser.
Upgrading
-
Backup
Configuration/Main.php! -
Delete
<path>and re-install by runningcomposer create-project opencultureconsulting/simple-oai-pmh <path>. -
Move your configuration back into
Configuration/Main.php. - 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=Identifyin your browser.
Updating
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.)
History
This project was originally initiated in 2002 by Internet Archive's Wayback Machine.
It was then modified in 2011 by Google Code Archive.
In 2013 further bugfixes.
The current implementation was derived from the latter in 2017 by German Literature Archive. It is a stand-alone version focused on easy deployment and file based record handling.
Sources
All versions of simple-oai-pmh with dependencies
ext-xml Version *