2017 © Pedro Peláez
 

library oai-pmh

Picturae OAI-PMH package. Can be used to create a OAI endpoint

image

picturae/oai-pmh

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  • Monday, June 11, 2018
  • by mech7
  • Repository
  • 24 Watchers
  • 4 Stars
  • 6,134 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 5 Forks
  • 3 Open issues
  • 29 Versions
  • 4 % Grown

The README.md

Latest Version Build Status Coverage Status Total Downloads, (*1)

Description

Provides an wrapper to produce a OAI-PMH endpoint., (*2)

Repository

To use the OAI-PMH Library it is required to make your own implementation of the \Picturae\OaiPmh\Interfaces\Repository interface, (*3)

Below is an example implementation needs to be modified to return your data, (*4)

<?php

namespace My\Repository;

use DateTime;
use OpenSkos2\OaiPmh\Concept as OaiConcept;
use Picturae\OaiPmh\Exception\IdDoesNotExistException;
use Picturae\OaiPmh\Implementation\MetadataFormatType as ImplementationMetadataFormatType;
use Picturae\OaiPmh\Implementation\RecordList as OaiRecordList;
use Picturae\OaiPmh\Implementation\Repository\Identity as ImplementationIdentity;
use Picturae\OaiPmh\Implementation\Set;
use Picturae\OaiPmh\Implementation\SetList;
use Picturae\OaiPmh\Interfaces\MetadataFormatType;
use Picturae\OaiPmh\Interfaces\Record;
use Picturae\OaiPmh\Interfaces\RecordList;
use Picturae\OaiPmh\Interfaces\Repository as InterfaceRepository;
use Picturae\OaiPmh\Interfaces\Repository\Identity;
use Picturae\OaiPmh\Interfaces\SetList as InterfaceSetList;

class Repository implements InterfaceRepository
{
    /**
     * @return string the base URL of the repository
     */
    public function getBaseUrl()
    {
        return 'http://my-data-provider/oai-pmh';
    }

    /**
     * @return Identity
     */
    public function identify()
    {
        return new ImplementationIdentity();
    }

    /**
     * @return InterfaceSetList
     */
    public function listSets()
    {
        $items = [];
        $items[] = new Set('my:spec', 'Title of spec');        
        return new SetList($items);
    }

    /**
     * @param string $token
     * @return InterfaceSetList
     */
    public function listSetsByToken($token)
    {
        $params = $this->decodeResumptionToken($token);
        return $this->listSets();
    }

    /**
     * @param string $metadataFormat
     * @param string $identifier
     * @return Record
     */
    public function getRecord($metadataFormat, $identifier)
    {
        // Fetch record
        $record = $this->getSomeRecord($identifier);

        // Throw exception if it does not exists
        if (!record) {
            throw new IdDoesNotExistException('No matching identifier ' . $identifier, $exc->getCode(), $exc);
        }

        return new Record($record);
    }

    /**
     * @param string $metadataFormat metadata format of the records to be fetch or null if only headers are fetched
     * (listIdentifiers)
     * @param DateTime $from
     * @param DateTime $until
     * @param string $set name of the set containing this record
     * @return RecordList
     */
    public function listRecords($metadataFormat = null, DateTime $from = null, DateTime $until = null, $set = null)
    {        
        $items = [];
        $items[] = new OaiConcept($concept);

        // Show token only if more records exists then are shown
        $token = $this->encodeResumptionToken($this->limit, $from, $until, $metadataFormat, $set);

        return new OaiRecordList($items, $token);
    }

    /**
     * @param string $token
     * @return RecordList
     */
    public function listRecordsByToken($token)
    {
        $params = $this->decodeResumptionToken($token);

        $records = $this->GetRecords($params);

        // Only show if there are more records available else $token = null;
        $token = $this->encodeResumptionToken(
            $params['offset'] + 100,
            $params['from'],
            $params['until'],
            $params['metadataPrefix'],
            $params['set']
        );    

        return new OaiRecordList($items, $token);
    }

    /**
     * @param string $identifier
     * @return MetadataFormatType[]
     */
    public function listMetadataFormats($identifier = null)
    {
        $formats = [];
        $formats[] = new ImplementationMetadataFormatType(
            'oai_dc',
            'http://www.openarchives.org/OAI/2.0/oai_dc.xsd',
            'http://www.openarchives.org/OAI/2.0/oai_dc/'
        );

        $formats[] = new ImplementationMetadataFormatType(
            'oai_rdf',
            'http://www.openarchives.org/OAI/2.0/rdf.xsd',
            'http://www.w3.org/2004/02/skos/core#'
        );

        return $formats;
    }    

    /**
     * Decode resumption token
     * possible properties are:
     *
     * ->offset
     * ->metadataPrefix
     * ->set
     * ->from (timestamp)
     * ->until (timestamp)
     *
     * @param string $token
     * @return array
     */
    private function decodeResumptionToken($token)
    {
        $params = (array) json_decode(base64_decode($token));

        if (!empty($params['from'])) {
            $params['from'] = new \DateTime('@' . $params['from']);
        }

        if (!empty($params['until'])) {
            $params['until'] = new \DateTime('@' . $params['until']);
        }

        return $params;
    }

    /**
     * Get resumption token
     *
     * @param int $offset
     * @param DateTime $from
     * @param DateTime $util
     * @param string $metadataPrefix
     * @param string $set
     * @return string
     */
    private function encodeResumptionToken(
        $offset = 0,
        DateTime $from = null,
        DateTime $util = null,
        $metadataPrefix = null,
        $set = null
    ) {
        $params = [];
        $params['offset'] = $offset;
        $params['metadataPrefix'] = $metadataPrefix;
        $params['set'] = $set;
        $params['from'] = null;
        $params['until'] = null;

        if ($from) {
            $params['from'] = $from->getTimestamp();
        }

        if ($util) {
            $params['until'] = $util->getTimestamp();
        }

        return base64_encode(json_encode($params));
    }

    /**
     * Get earliest modified timestamp
     *
     * @return DateTime
     */
    private function getEarliestDateStamp()
    {
        // Fetch earliest timestamp
        return new DateTime();
    }
}

Sending a response

To create a request and send a response you will need something that can create a PSR 7 server request and emit a PSR 7 response, (*5)

In this example we use zend-diactoros, (*6)

composer require zendframework/zend-diactoros

// Where $repository is an instance of \Picturae\OaiPmh\Interfaces\Repository
$repository = new \Your\Implementation\Repository();
$provider = new \Picturae\OaiPmh\Provider($repository);

$request = Zend\Diactoros\ServerRequestFactory::fromGlobals();
$provider = new Picturae\OaiPmh\Provider($repository, $request);
$response = $provider->getResponse();
// Send PSR 7 Response
(new Zend\Diactoros\Response\SapiEmitter())->emit($response);

Validators

Values for setSpec must be validated yourself before adding them to the header, (*7)

```php $header = new \Picturae\OaiPmh\Validator\SetSpecValidator(); $boolean = $header->isValid($value); ````, (*8)

The Versions

11/06 2018

dev-develop

dev-develop

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3 GPL-3.0-or-later

The Requires

 

The Development Requires

by Picturae

11/06 2018

dev-master

9999999-dev

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3 GPL-3.0-or-later

The Requires

 

The Development Requires

by Picturae

11/06 2018

0.5.20

0.5.20.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPL-3.0-or-later

The Requires

 

The Development Requires

by Picturae

11/06 2018

0.5.19

0.5.19.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

06/01 2017

dev-feature/multidesc

dev-feature/multidesc

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

22/11 2016

0.5.18

0.5.18.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

21/11 2016

0.5.17

0.5.17.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

05/09 2016

0.5.16

0.5.16.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

20/05 2016

0.5.15

0.5.15.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

19/02 2016

0.5.14

0.5.14.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

11/01 2016

0.5.13

0.5.13.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

11/01 2016

0.5.12

0.5.12.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

10/12 2015

0.5.11

0.5.11.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

10/12 2015

0.5.10

0.5.10.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

10/12 2015

0.5.9

0.5.9.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

10/12 2015

0.5.8

0.5.8.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

01/12 2015

0.5.7

0.5.7.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

01/12 2015

0.5.6

0.5.6.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

30/11 2015

0.5.5

0.5.5.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

13/10 2015

0.5.4

0.5.4.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

12/10 2015

0.5.3

0.5.3.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

30/09 2015

0.5.2

0.5.2.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

28/09 2015

0.5.1

0.5.1.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

17/09 2015

0.5.0

0.5.0.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

GPLv3

The Requires

 

The Development Requires

by Picturae

16/09 2015

0.4.0

0.4.0.0

Picturae OAI-PMH package. Can be used to create a OAI endpoint

  Sources   Download

proprietary

The Requires

 

The Development Requires

by Picturae

16/09 2015

0.3.1

0.3.1.0

Picturae OAI package. Can be used to create a OAI endpoint

  Sources   Download

proprietary

The Development Requires

by Picturae

03/08 2015

0.3.0

0.3.0.0

Picturae OAI package. Can be used to create a OAI endpoint

  Sources   Download

proprietary

The Development Requires

by Picturae

08/12 2014

0.2

0.2.0.0

Picturae OAI package. Can be used to create a OAI endpoint

  Sources   Download

proprietary

The Development Requires

by Picturae

02/12 2014

0.1

0.1.0.0

Picturae OAI package. Can be used to create a OAI endpoint

  Sources   Download

proprietary

The Development Requires

by Picturae