opencultureconsulting / oai_pmh
这是一个独立且易于安装的数据提供程序,实现了开放档案倡议的元数据收割协议(OAI-PMH)。
Requires
- php: 7.4.*|8.0.*|8.1.*|8.2.*
- ext-xml: *
Replaces
This package is auto-updated.
Last update: 2024-05-16 12:04:43 UTC
README
这是一个独立且易于安装的数据提供程序,实现了开放档案倡议的元数据收割协议(OAI-PMH)。它使用目录名作为metadataPrefix
,文件名作为identifier
,文件mtime作为时间戳,从XML文件的目录中提供任何元数据格式的记录。0字节文件被视为已删除的记录,并相应处理。使用文件管理续传令牌。目前不支持集合。
只需将记录作为XML文件放入数据目录,调整一些配置设置,您就可以开始使用了!
可以在这里找到演示安装。
安装
-
运行
composer create-project opencultureconsulting/simple-oai-pmh <path>
。 -
在一个不公开访问的位置(例如,不在
<path>
之外)创建一个数据目录。为每个您想提供的格式(例如,metadataPrefix
)在指定的数据目录内创建一个子目录。 -
将
Configuration/Main.template.php
复制到Configuration/Main.php
,并根据您的偏好编辑设置。别忘了将$config['dataDirectory']
指向您刚刚创建的数据目录。 -
根据其格式将记录放入相应的目录。每个记录都必须是一个独立的XML文件,其
identifier
作为文件名(例如,文件12345678.xml可以使用identifier
12345678访问)。可选地,您可以通过保留删除记录的0字节文件来维护删除。 -
恭喜!现在您正在运行自己的Simple OAI-PMH 2.0数据提供程序。您可以通过在浏览器中调用
index.php?verb=Identify
来访问入口点。
升级
-
备份
Configuration/Main.php
! -
删除
<path>
并通过运行composer create-project opencultureconsulting/simple-oai-pmh <path>
重新安装。 -
将您的配置移回
Configuration/Main.php
。 -
恭喜!现在您正在运行Simple OAI-PMH 2.0数据提供程序的最新版本。您可以通过在浏览器中调用
index.php?verb=Identify
来访问入口点。
更新
使用update.php
脚本更新您的记录同样简单!该脚本自动处理删除,通过为删除的记录保留0字节文件来维护。只需从命令行调用php update.php
并遵循说明。(当然,您也可以手动简单地替换记录。)
历史记录
该项目最初于2002年由Heinrich Stamerjohanns在奥尔登堡大学发起。他的最新实现仍然可以通过互联网档案馆的Wayback Machine找到。
该文档于2011年由李建峰在阿德莱德大学进行修改,为植物加速器。修改后的版本可以在Google代码归档中找到。
2013年,联邦圣卡塔琳娜大学丹尼尔·内伊斯·阿劳若再次修改了项目,以便将其与Moodle集成。他的实现可以在GitHub上找到。2014年,卡齐米尔·皮特鲁谢夫斯基提供了一些进一步的错误修复。
当前的实现是在2017年由塞巴斯蒂安·迈耶在开放文化咨询公司为德国文学档案馆开发的,是从后者衍生出来的。这是一个独立的版本,专注于易于部署和基于文件的记录处理。