Download the PHP package olendorf/ezid-php without Composer
On this page you can find all versions of the php package olendorf/ezid-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download olendorf/ezid-php
More information about olendorf/ezid-php
Files in olendorf/ezid-php
Package ezid-php
Short Description A library to simplify interacting with the EZID API for managing DOIs and ARKs.
License MIT
Homepage https://github.com/olendorf/ezid-php
Informations about the package ezid-php
EZID-PHP
EZID-PHP is a simple wrapper around the Guzzle HTTP client intended to simplify interaction with the EZID DOI service. It is configurable to use your own authentication and shoulders. Its still early in development. Feel free to use it, but please be be aware there are probably issues and bugs. If you find them report them or fix them!
For further information about the EZID API visit http://ezid.lib.purdue.edu/doc/apidoc.html.
Installation
The recommended way to install Ezid-php is through Composer.
Next, run the Composer command to install the latest stable version of Guzzle:
After installing, you need to require Composer's autoloader:
You can then later update Guzzle using composer:
OR
Edit your compuser.json to include the following
Configuring
Copy and rename to . Then edit it to reflect your credentials and shoulders. If upi do not wish to use the config file just delete it (or don't copy and rename in the first place). You can always override the values as you wish.
Usage
This package uses the Guzzle package to handle HTTP requests and is really just a wrapper for that. All methods that interact with the EZID API (i.e. that make an HTTP request) return a Guzzle response. For more information about Guzzle visit http://docs.guzzlephp.org/en/latest/.
Creating The Connection
Creating And Minting Identifiers
Retrieving Metadata
Modifying The Metadata
Deleting An Identifier
This will only work if the status of the identifier is reserved.
Running The Tests
I used PHPSpec for testing, mostly to try it out. One issue I ran into was the difficulty in testing an external API. Rather than mocking out a web server, I just used the actual EZID service, couples with the testing shoulders they provide. If you want to run the tests, you will need to have an active EZID account, and use your credentials in the ezid.json. Also, in some cases tests may fail if the EZID service is having issues. In the future I may take the time to mock it out correctly.
Contributing
Contributions are welcome. Either submit an issue, or fork the repo and then submit a Pull request.