snapshotpl/last-fm-client

LastFmClient

Modern Last.fm API client for php, _(*1)

Last.fm API documentation, _(*2)

Usage

You can call API methods using existing services:, _(*3)

<?php

require __DIR__ . '/vendor/autoload.php';

$auth = new LastFmClient\Auth();
$auth->setApiKey('your-api-key');
$auth->setSecret('your-secret');
$auth->setToken('user-token');
$auth->setSession('user-session');

$transport = new LastFmClient\Transport\Curl();

$client = new LastFmClient\Client($auth, $transport);

$trackService = new LastFmClient\Service\Track();
$trackService->setClient($client);

$response = $trackService->getInfo('Numb', 'Linkin Park');

var_dump($response->getData());

If you want to call custom method use LastFmClient\Client:, _(*4)

$client->call('resource.getAwesomeness', [], LastFmClient\Transport\TransportInterface::METHOD_GET);

How to scrobble?

It's very simple! Prepare LastFmClient\Auth object with api key, secret, token and session key. Then just call method from LastFmClient\Service\Track:, _(*5)

$trackService->scrobble('Seven Lions', 'Days to Come', $timestamp);

$timestamp is optional and can be integer with timestamp time or DateTime object., _(*6)

You can scrobble multiple tracks in one request:, _(*7)

$trackService->scrobbleBatch([
    [
        'artist' => 'Linkin Park',
        'track' => 'Numb',
        'timestamp' => time()-1000,
    ],
    [
        'artist' => 'Seven Lions',
        'track' => 'Days to Come',
        'timestamp' => time()-1200,
    ],
]);

How to get Token and Session

You need to redirect user to auth page in Last.Fm:, _(*8)

$url = $client->getAuthUrl();
header('Location: '.$url);

In callback url you will receive query string parameter token., _(*9)

$authService = LastFmClient\Service\Auth();
$authService->setClient($client);
$data = $authService->getSession()->getData();
var_dump($data);

More information: * http://www.lastfm.pl/api/webauth * http://www.lastfm.pl/api/authspec, _(*10)

Transport

To make calls in API we provide simple CURL transport. We have in plan implements others transports like: * Guzzle * Httpfull * Zend\Http, _(*11)

To use own transport just implement LastFmClient\Transport\TransportInterface, _(*12)

Installation

Add to composer.json:, _(*13)

{
    "require": {
        "snapshotpl/last-fm-client": "~1.0"
    }
}