WARNING: This library is no longer maintained. However, the code remains public as an example of how to use the API.
The easiest way to install the OCLC Auth library is with Composer. Composer is a PHP dependency management tool that let's you declare the dependencies your project requires and installs them for you.
Sample Composer file
{
"name" : "MyApp",
"repositories": [
{
"type": "git",
"url": "https://github.com/OCLC-Developer-Network/worldcat-discovery-php.git"
},
{
"type": "git",
"url": "https://github.com/OCLC-Developer-Network/oclc-auth-php.git"
}
],
"require" : {
"worldcat/discovery" : "^1.0"
}
}
In a Terminal Window
$ cd {YOUR-PROJECT-ROOT}
$ pico composer.json
Copy the contents of the sample composer file above to the composer.json
file.
Download composer and use the install
command to read the JSON file created in step 1 to install the WSKey library in a vendor direcory
$ curl -s https://getcomposer.org/installer | php
$ php composer.phar install
To start using this library you need to include the OCLC Auth library in your code. Add the following to the top of your file:
<?php
require_once('vendor/autoload.php');
Basic Example Reading a Bibliographic Record looks like this
require_once('vendor/autoload.php');
use OCLC\Auth\WSKey;
use OCLC\Auth\AccessToken;
use WorldCat\Discovery\Bib;
$key = 'api-key';
$secret = 'api-key-secret';
$options = array('services' => array('WorldCatDiscoveryAPI', 'refresh_token'));
$wskey = new WSKey($key, $secret, $options);
$accessToken = $wskey->getAccessTokenWithClientCredentials('128807', '128807');
$bib = Bib::Find(7977212, $accessToken);
if (is_a($bib, 'WorldCat\Discovery\Error')) {
echo $bib->getErrorCode();
echo $bib->getErrorMessage();
} else {
echo $bib->getName();
print_r($bib->getID());
echo $bib->getID();
print_r($bib->type());
echo $bib->type();
print_r($bib->getAuthor());
echo $bib->getAuthor()->getName();
$contributors = array_map(function ($contributor) {
return $contributor->getName();
}, $bib->getContributors());
print_r($contributors);
}