opencultureconsulting / simple-oai-pmh
这是一个独立的、易于安装的数据提供程序,实现了开放存档倡议的元数据采集协议(OAI-PMH)。
Requires
- php: 7.4.*|8.0.*|8.1.*|8.2.*
- ext-xml: *
Replaces
README
这是一个独立的、易于安装的数据提供程序,实现了开放存档倡议的元数据采集协议(OAI-PMH)。它使用目录名作为metadataPrefix
,文件名作为identifier
,文件mtime作为时间戳来提供任何元数据格式的记录。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
并按照说明操作。(当然,您也可以简单地手动替换记录。)
历史
该项目最初由Heinrich Stamerjohanns于2002年在奥尔多尔登大学启动。他最新的实现仍然可以通过互联网档案馆的时光机器找到。
然后在2011年由Jianfeng Li在阿德莱德大学为植物加速器进行了修改。修改后的版本可以在谷歌代码存档中找到。
2013年,来自Federal University of Santa Catarina的Daniel Neis Araujo对项目进行了再次修改,以便与Moodle集成。他的实现可以在GitHub上找到。2014年,Kazimierz Pietruszewski提供了一些进一步的错误修复。
当前的实现是在2017年由Sebastian Meyer在Open Culture Consulting为德国文学档案馆所开发的,它是一个独立的版本,专注于易于部署和基于文件的记录处理。