marvelley/lastfm-api

A last.fm API client

Last.fm API client

This is a client for the last.fm API. It uses the Guzzle web service library. The client API is a custom web service client based on Guzzle\Service\Client., _(*1)

, _(*2)

Installation

Use composer to install the library and all its dependencies:, _(*3)

composer require "marvelley/lastfm-api:1.0.*@dev" 

Basic Usage Example

Before you can use the library you have to request your API key on the [last.fm API page][2].
Put that key in the following code and run the code from the command line:, _(*4)

require 'vendor/autoload.php';

use Marvelley\Lastfm\Api\LastfmApiClient;

$l = LastfmApiClient::factory(array('api_key' => 'your_api_key'));
$ai = $l->getCommand('artist.getInfo', array(
    'artist' => 'Elvis Presley', 
    "format" => "json"
));
$result = $ai->execute();
echo "Similar artists:\n";
foreach($result['artist']['similar']['artist'] as $artist) {
    printf("  - %s\n", $artist['name']);
}

 Running integration tests

Before running the test suite you need to configure a specific environment variable with a valid last.fm API key. For example, from your terminal:, _(*5)

$ export LAST_FM_PHP_CLIENT_API_KEY=your_api_key

or add a similar entry to your bash/zsh/whatever config file., _(*6)

You can then run the test suite via:, _(*7)

$ phpunit

from the root of the project directory (assuming you have PHPUnit installed and on the path)., _(*8)