README

baelor.io 的 PHP 库。

内容

• 安装
• 简介
• 端点
  • 创建用户
  • 以现有用户登录
  • 获取专辑
  • 从专辑中获取歌曲
  • 获取所有歌曲
  • 获取单首歌曲
  • 歌词
  • Bae
• 示例
  • 行长度
• 鸣谢

安装

$ composer install --no-dev -o

简介

baelorphp 是一个用于 baelor.io Taylor Swift API 的 PHP 库。

要获取 baelor.io 的 API 密钥，请运行 创建新 API 用户 示例。

快速示例

让我们加载 Taylor Swift 的所有专辑。

use Duffleman\baelor\BaelorAPI;

$api = new BaelorAPI('api-key');
$albumCollection = $api->getAlbums();

您也可以将其包裹在 try/catch 标签中，以查看是否抛出（如果有）错误。

端点

以下是我们可以做的，也可以查看 baelor.io 文档 以获取完整的 API 端点列表。

创建用户

use Duffleman\baelor\BaelorAPI;

$api = new BaelorAPI();
$user = $api->createUser('myUsername', 'myEmail', 'myPassword');

$ourNewAPIKey = $user->api_key;

以现有用户登录

use Duffleman\baelor\BaelorAPI;

$api = new BaelorAPI();
$api->login('myUsername', 'myPassword');

$response = $api->getAlbums(); // Returns full set of Albums.

获取单个专辑

use Duffleman\baelor\BaelorAPI;

$api = new BaelorAPI('api-key');

$album = $api->getAlbums('1989');

该专辑中的歌曲

基于上述示例进行扩展。

use Duffleman\baelor\BaelorAPI;

$api = new BaelorAPI('api-key');

$album = $api->getAlbums('1989');

$songs = $album->attributes;

所有歌曲

use Duffleman\baelor\BaelorAPI;

$api = new BaelorAPI('api-key');

$songCollection = $api->getSongs();

获取单首歌曲

use Duffleman\baelor\BaelorAPI;

$api = new BaelorAPI('api-key');

$song = $api->getSongs('style');

$length = $song->length; // We can access attributes directly.

歌词

歌词的用法略有不同。但同样简单。

use Duffleman\baelor\BaelorAPI;
use Duffleman\baelor\Results\Lyrics;

$api = new BaelorAPI('api-key');

$song = $api->getSongs('style');

$lyrics = new Lyrics($song, $api);

echo($lyrics->toHTML());

Bae 状态

use Duffleman\baelor\BaelorAPI;

$api = new BaelorAPI('api-key');

$bae = $api->getBae('word');
// or
$bae = $api->getBae();

var_dump($bae);

示例

找到歌曲中最长的行

use Duffleman\baelor\BaelorAPI;
use Duffleman\baelor\Results\Lyrics;

$api = new BaelorAPI('api-key');

$song = $api->getSongs('style');
$lyrics = new Lyrics($song, $api);

$lines = $lyrics->toArray(true); // true because we do want to strip empty lines.

$longestLength = 0;
$longestLine = '';
foreach($lines as $line) {
  $lineLength = strlen($line);
  if($lineLength > $longestLength) {
    $longestLength = $lineLength;
    $longestLine = $line;
  }
}

echo("The longest line is {$lineLength} characters long. It reads: {$longestLine}.");

鸣谢

Baelor API 由 Alex Forbes-Reed @0xdeafcafe 创建

baelorjs 库 由 Jamie Davies 创建 @viralpickaxe

baelorphp 库 由 George Miller 创建 @duffleman