ricbra/discogs-bundle

Bundle around the Discogs API client

RicbraDiscogsBundle

, _(*1)

This bundle provides a simple integration of the "Discogs library" into Symfony2. You can find more information about this library on its dedicated page at http://www.discogs.com/developers/index.html., _(*2)

``` php <?php, <sub>(*3)</sub>

$discogs = $this->container->get('discogs'); ````, <sub>(*4)</sub>

The bundle provides a new discogs service that returns an instance of Discogs\Service., <sub>(*5)</sub>

Installation

$ composer require ricbra/discogs-bundle ~1.0.0

Enable the bundle

Enable the bundle in the kernel:, <sub>(*6)</sub>

``` php <?php // app/AppKernel.php, <sub>(*7)</sub>

public function registerBundles() { $bundles = array( // ..., <sub>(*8)</sub>

    new Ricbra\Bundle\DiscogsBundle\RicbraDiscogsBundle(),
);

}, <sub>(*9)</sub>

### Configuration

To enable or disable the throttle:

    ricbra_discogs:
        throttle:
            enabled: false # or true

To enable OAuth you've to also use some third party library for connecting and authorization. This bundle provides
support for HWIOAuthBundle. The <code>token_provider_id</code> is the service id which provider the token and token
secret. You get this after authenticating at Discogs.

    ricbra_discogs:
        oauth:
            enabled: true
            consumer_key: _get_this_from_discogs_
            consumer_secret: _get_this_from_discogs_
            token_provider_id: ricbra_discogs.hwi_oauth_token_provider

## Basic Usage

The only thing to do is to request the `discogs` service from the container to get
an instance of `Discogs\Service` and start issuing API calls:

``` php
<?php

$discogs = $this->container->get('discogs');

$artist = $discogs->getArtist([
    'id' => 120
]);

echo $artist['name'];