README

API 密钥
安装
Laravel 安装
使用方法
官方 API 文档

API 密钥

您可以在 http://www.last.fm/api/account/create 创建一个 last.fm API 账户。

安装

通过 Composer

$ composer require barryvanveen/lastfm

Laravel 安装

将 LASTFM_API_KEY 变量添加到您的 .env 配置中。您也可以发布默认配置并自行修改

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

通过添加 LastfmServiceProvider 更新 config/app.php

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

如果您使用的是 Laravel 5.5 或更高版本，服务提供者将通过 Laravel 的包发现机制自动检测。

已测试与 Laravel 5.* 兼容，但可能适用于大多数版本，因为它非常简单。如果您发现它不适用于您，请创建一个问题。

使用方法

基本示例

use Barryvanveen\Lastfm\Lastfm;
use GuzzleHttp\Client;
 
$lastfm = new Lastfm(new Client(), 'YourApiKey');
    
$albums = $lastfm->userTopAlbums('AnyUsername')->get();

Laravel 示例

use Barryvanveen\Lastfm\Lastfm;
 
public function index(Lastfm $lastfm)
{
    $albums = $lastfm->userTopAlbums('AnyUsername')->get();
    
    return view('home', compact('albums'));
}

所有可用方法

// 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'));

过滤结果

// 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();

有效时间范围

// 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';

官方 API 文档

请在 http://www.last.fm/api 阅读官方 API 文档。

变更日志

请参阅 CHANGELOG 了解最近更改的详细信息。

测试

将 phpunit.xml.dist 复制到 phpunit.xml。然后使用以下命令运行测试：

$ composer test

贡献

请参阅 CONTRIBUTING 和 CONDUCT 了解详细信息。

安全性

如果您发现任何与安全相关的问题，请通过电子邮件 barryvanveen@gmail.com 联系，而不是使用问题跟踪器。

鸣谢

许可协议

MIT 许可协议 (MIT)。请参阅许可文件了解更多信息。

barryvanveen / lastfm

维护者

详细信息