Last.fm API client for PHP 8

![Software License][ico-license] , _(*1)

API keys
Installation
Laravel installation
Usage
Official API docs

API keys

You can create a last.fm API account at http://www.last.fm/api/account/create., _(*2)

Installation

Via Composer, _(*3)

``` bash $ composer require barryvanveen/lastfm, _(*4)


## Laravel installation

Add a LASTFM_API_KEY variable to your .env configuration. You could also publish the default configuration and alter it
 yourself:

```php
php  artisan vendor:publish --provider="Barryvanveen\Lastfm\LastfmServiceProvider"

Update config/app.php by adding the LastfmServiceProvider:, _(*5)

'providers' => [
    ...
    Barryvanveen\Lastfm\LastfmServiceProvider::class,
];

If you are using Laravel 5.5 or higher, the service provider will be detected automagically by Laravel's package discovery., _(*6)

Tested against Laravel 5.* but probably works in most versions because it is so simple. Please create an issue if it doesn't work for you., _(*7)

Usage

Basic example

use Barryvanveen\Lastfm\Lastfm;
use GuzzleHttp\Client;

$lastfm = new Lastfm(new Client(), 'YourApiKey');

$albums = $lastfm->userTopAlbums('AnyUsername')->get();

Laravel example

use Barryvanveen\Lastfm\Lastfm;

public function index(Lastfm $lastfm)
{
    $albums = $lastfm->userTopAlbums('AnyUsername')->get();

    return view('home', compact('albums'));
}

All available methods

// Get top albums for user
$albums = $lastfm->userTopAlbums('AnyUsername')->get();

// Get top artists for user
$artists = $lastfm->userTopArtists('AnyUsername')->get();

// Get recent tracks for user
$tracks = $lastfm->userRecentTracks('AnyUsername')->get();

// Get user info
$info = $lastfm->userInfo('AnyUsername')->get();

// Get track that user is now listening to, or FALSE
$trackOrFalse = $lastfm->nowListening('AnyUsername'); 

// Get the weekly top albums given a starting day 
$albums = $lastfm->userWeeklyTopAlbums('AnyUsername', new \DateTime('2017-01-01'));                      

// Get the weekly top artists given a starting day 
$artists = $lastfm->userWeeklyTopArtists('AnyUsername', new \DateTime('2017-01-01'));

// Get the weekly top tracks given a starting day 
$tracks = $lastfm->userWeeklyTopTracks('AnyUsername', new \DateTime('2017-01-01'));

Filtering results

// Define time period for results
$lastfm->userTopAlbums('AnyUsername')
       ->period(Barryvanveen\Lastfm\Constants::PERIOD_WEEK)
       ->get();

// Limit number of results
$lastfm->userTopAlbums('AnyUsername')
       ->limit(5)
       ->get();     

// Retrieve paginated results
$lastfm->userTopAlbums('AnyUsername')
       ->limit(5)
       ->page(2)
       ->get();

Valid time periods

// use these constants as an argument to ->period()
Barryvanveen\Lastfm\Constants::PERIOD_WEEK     = '7day';
Barryvanveen\Lastfm\Constants::PERIOD_MONTH    = '1month';
Barryvanveen\Lastfm\Constants::PERIOD_3_MONTHS = '3month';
Barryvanveen\Lastfm\Constants::PERIOD_6_MONTHS = '6month';
Barryvanveen\Lastfm\Constants::PERIOD_YEAR     = '12month';
Barryvanveen\Lastfm\Constants::PERIOD_OVERALL  = 'overall';