simple-oai-pmh/doc/oaidp-config_8php.html

238 lines
14 KiB
HTML
Raw Normal View History

<!-- This comment will put IE 6, 7 and 8 in quirks mode -->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>OAI PHP: oaidp-config.php File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javaScript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body onload='searchBox.OnSelectItem(0);'>
<!-- Generated by Doxygen 1.6.3 -->
<script type="text/javascript"><!--
var searchBox = new SearchBox("searchBox", "search",false,'Search');
--></script>
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
<li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<img id="MSearchSelect" src="search/search.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</div>
</li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File&nbsp;List</span></a></li>
<li><a href="globals.html"><span>File&nbsp;Members</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>oaidp-config.php File Reference</h1>
<p>Configuration file of current data provider.
<a href="#_details">More...</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Constants</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oaidp-config_8php.html#a2d07c29fad973dae16d991239170ff2d">SHOW_QUERY_ERROR</a> </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oaidp-config_8php.html#a9f5f084db962d47cfd18de99129571a7">CONTENT_TYPE</a> </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oaidp-config_8php.html#ab7ebb1d3d7394f242a35aedb9811aa77">MAXRECORDS</a> </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oaidp-config_8php.html#a35044ef78083407dff11647b61742c92">MAXIDS</a> </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oaidp-config_8php.html#a9b86d040a36908866c7a1a615e0d541d">TOKEN_VALID</a> </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oaidp-config_8php.html#afe2c0dd686a18d4fa494746964b6eb16">TOKEN_PREFIX</a> </td></tr>
<tr><td colspan="2"><h2>Variables</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oaidp-config_8php.html#aa51e14dc8b7351ea30e82829cb69d504">$identifyResponse</a> = array()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oaidp-config_8php.html#a99cfcd818d46c54bb56d6100a25f8442">$compression</a> = null</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>This is the configuration file for the PHP OAI Data Provider. Please read through the WHOLE file, there are several things, that need to be adjusted.</p>
<p>The response may may be compressed for better performace:</p>
<ul>
<li>Compression : a compression encoding supported by the repository. The recommended values are those defined for the Content-Encoding header in Section 14.11 of RFC 2616 describing HTTP 1.1. A compression element should not be included for the identity encoding, which is implied.</li>
</ul>
<p>Some other used variables:</p>
<ul>
<li><b>$adminEmail</b>: the e-mail addresses of administrators of the repository.</li>
</ul>
<ul>
<li><b>$repositoryIdentifier</b> : For a data provider there is only one. For repositories to comply with the oai format it has to be unique identifiers for items records. Basically using domainname will be fine. See: <a href="http://www.openarchives.org/OAI/2.0/guidelines-oai-identifier.htm.">http://www.openarchives.org/OAI/2.0/guidelines-oai-identifier.htm.</a></li>
</ul>
<ul>
<li><b>$SETS</b>: An array with key words . List of supported SETs.</li>
</ul>
<ul>
<li><b>$METADATAFORMATS</b>: List of supported metadata formats. It is a two-dimensional array with keys. Each supported format is one element of this array at the first dimension. The key is the name of a metadata format. The exact number of items within each format associated array depends on the nature of a metadata format. Most definitions are done here but handlers themselves are defined in separated files because only the names of PHP script are listed here.<ul>
<li>metadataPrefix</li>
<li>schema</li>
<li>metadataNamespace</li>
<li>myhandler</li>
<li>other optional items: record_prefix, record_namespace and etc.</li>
</ul>
</li>
</ul>
<ul>
<li><b>$SQL</b>: Settings for database and queries from database</li>
</ul>
<ul>
<li><b>$DSN</b>: DSN for connecting your database. Reference PDO for details.</li>
</ul>
<p>The rest of settings will not normally need to be adjusted. Read source code for details. </p>
<hr/><h2>Constant Documentation</h2>
<a class="anchor" id="a2d07c29fad973dae16d991239170ff2d"></a><!-- doxytag: member="oaidp&#45;config.php::SHOW_QUERY_ERROR" ref="a2d07c29fad973dae16d991239170ff2d" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="oaidp-config_8php.html#a2d07c29fad973dae16d991239170ff2d">SHOW_QUERY_ERROR</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether to show error message for dubug. For installation, testing and debuging set SHOW_QUERY_ERROR to TRUE If set to TRUE, application will die and display query and database error message as soon as there is a problem. Do not set this to TRUE on a production site, since it will show error messages to everybody. If set FALSE, will create XML-output, no matter what happens. </p>
</div>
</div>
<a class="anchor" id="a9f5f084db962d47cfd18de99129571a7"></a><!-- doxytag: member="oaidp&#45;config.php::CONTENT_TYPE" ref="a9f5f084db962d47cfd18de99129571a7" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="oaidp-config_8php.html#a9f5f084db962d47cfd18de99129571a7">CONTENT_TYPE</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The content-type the WWW-server delivers back. For debug-puposes, "text/plain" is easier to view. On a production site you should use "text/xml". </p>
</div>
</div>
<a class="anchor" id="ab7ebb1d3d7394f242a35aedb9811aa77"></a><!-- doxytag: member="oaidp&#45;config.php::MAXRECORDS" ref="ab7ebb1d3d7394f242a35aedb9811aa77" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="oaidp-config_8php.html#ab7ebb1d3d7394f242a35aedb9811aa77">MAXRECORDS</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Maximum mumber of the records to deliver (verb is ListRecords) If there are more records to deliver a ResumptionToken will be generated. </p>
</div>
</div>
<a class="anchor" id="a35044ef78083407dff11647b61742c92"></a><!-- doxytag: member="oaidp&#45;config.php::MAXIDS" ref="a35044ef78083407dff11647b61742c92" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="oaidp-config_8php.html#a35044ef78083407dff11647b61742c92">MAXIDS</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Maximum mumber of identifiers to deliver (verb is ListIdentifiers) If there are more identifiers to deliver a ResumptionToken will be generated. </p>
</div>
</div>
<a class="anchor" id="a9b86d040a36908866c7a1a615e0d541d"></a><!-- doxytag: member="oaidp&#45;config.php::TOKEN_VALID" ref="a9b86d040a36908866c7a1a615e0d541d" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="oaidp-config_8php.html#a9b86d040a36908866c7a1a615e0d541d">TOKEN_VALID</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>After 24 hours resumptionTokens become invalid. Unit is second. </p>
</div>
</div>
<a class="anchor" id="afe2c0dd686a18d4fa494746964b6eb16"></a><!-- doxytag: member="oaidp&#45;config.php::TOKEN_PREFIX" ref="afe2c0dd686a18d4fa494746964b6eb16" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="oaidp-config_8php.html#afe2c0dd686a18d4fa494746964b6eb16">TOKEN_PREFIX</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Where token is saved and path is included </p>
</div>
</div>
<hr/><h2>Variable Documentation</h2>
<a class="anchor" id="aa51e14dc8b7351ea30e82829cb69d504"></a><!-- doxytag: member="oaidp&#45;config.php::$identifyResponse" ref="aa51e14dc8b7351ea30e82829cb69d504" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">$identifyResponse = array()</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Identifier settings. It needs to have proper values to reflect the settings of the data provider.</p>
<ul>
<li>$identifyResponse['repositoryName'] : compulsory. A human readable name for the repository;</li>
<li>$identifyResponse['baseURL'] : compulsory. The base URL of the repository;</li>
<li>$identifyResponse['protocolVersion'] : compulsory. The version of the OAI-PMH supported by the repository;</li>
<li>$identifyResponse['earliestDatestamp'] : compulsory. A UTCdatetime that is the guaranteed lower limit of all datestamps recording changes, modifications, or deletions in the repository. A repository must not use datestamps lower than the one specified by the content of the earliestDatestamp element. earliestDatestamp must be expressed at the finest granularity supported by the repository.</li>
<li>$identifyResponse['deletedRecord'] : the manner in which the repository supports the notion of deleted records. Legitimate values are no ; transient ; persistent with meanings defined in the section on deletion.</li>
<li>$identifyResponse['granularity'] : the finest harvesting granularity supported by the repository. The legitimate values are YYYY-MM-DD and YYYY-MM-DDThh:mm:ssZ with meanings as defined in ISO8601. </li>
</ul>
</div>
</div>
<a class="anchor" id="a99cfcd818d46c54bb56d6100a25f8442"></a><!-- doxytag: member="oaidp&#45;config.php::$compression" ref="a99cfcd818d46c54bb56d6100a25f8442" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">$compression = null</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Compression methods supported. Optional (multiple). Default: null.</p>
<p>Currently only gzip is supported (you need output buffering turned on, and php compiled with libgz). The client MUST send "Accept-Encoding: gzip" to actually receive </p>
</div>
</div>
</div>
<!--- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&nbsp;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&nbsp;</span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&nbsp;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&nbsp;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&nbsp;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&nbsp;</span>Enumerations</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<hr class="footer"/><address style="text-align: right;"><small>Generated on Thu Jun 16 12:49:22 2011 for OAI PHP by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.3 </small></address>
</body>
</html>