sprain/bookfinder

A php library to find books via different apis

0.2 2014-09-22 19:04 UTC

This package is auto-updated.

Last update: 2024-10-29 04:14:37 UTC


README

A php library to find books via different apis

Functionalities

  • Find books by ISBN over different providers
  • Included providers:
    • Google Books API
    • Amazon Product Advertising API
  • Add custom providers to find books e.q. in local database

Installation

Add SprainBookFinder in your composer.json:

{
    "require": {
        "sprain/bookfinder": "~0.1"
    }
}

Now tell composer to download the bundle by running the command:

$ php composer.phar update sprain/bookfinder

Usage

See example.php for usage.

Add custom provider

Adding your own provider is simple:

Create provider

<?php

namespace Acme\Your\Namespace;

use Sprain\BookFinder\Providers\BaseProvider\BaseProvider;
use Sprain\BookFinder\Providers\Interfaces\ProviderInterface;

class MyCustomProvider extends BaseProvider implements ProviderInterface
{
    public function searchByIsbn($isbn)
    {
        // perform search, e.q. in a local database
    }

    public function getResults()
    {
        // return array of normalized results
    }

    public function getDefaultName()
    {
        return 'My Own Awesome Book Provider';
    }
}

Add provider to BookFinder

Add your provider to the providers array as seen in example.php.

License

This bundle is under the MIT license. See the complete license in the bundle:

Resources/meta/LICENSE