README

此包为PHP League的OAuth 2.0 Client提供Spotify OAuth 2.0支持。

要求

以下版本的PHP受到支持

• PHP 8.3

请按照Spotify说明创建应用程序并获得所需凭据。

安装

您可以使用Composer安装此包

composer require dnklbgn/oauth2-spotify

或者，您可以将以下内容添加到您的composer.json文件中

{
    "require": {
        "dnklbgn/oauth2-spotify": "^1.0"
    }
}

用法

授权码流

$provider = new \Dnklbgn\OAuth2\Client\Provider\Spotify([
    'clientId' => '{spotify-client-id}',
    'clientSecret' => '{spotify-client-secret}',
    'redirectUri' => 'https://example.com/callback-url',
]);

if (!isset($_GET['code'])) {
    // If we don't have an authorization code then get one
    $authUrl = $provider->getAuthorizationUrl();
    $_SESSION['oauth2state'] = $provider->getState();
    header('Location: ' . $authUrl);
    exit;
} elseif (empty($_GET['state']) || ($_GET['state'] !== $_SESSION['oauth2state'])) {
    // State is invalid, possible CSRF attack in progress
    unset($_SESSION['oauth2state']);
    exit('Invalid state');
} else {
    // Try to get an access token (using the authorization code grant)
    $token = $provider->getAccessToken('authorization_code', [
        'code' => $_GET['code'],
    ]);

    try {
        // Optional: Now you have a token you can look up a users profile data
        // We got an access token, let's now get the user's details
        /** @var \Dnklbgn\OAuth2\Client\Provider\SpotifyResourceOwner $user */
        $resourceOwnerDetails = $provider->getResourceOwner($token);

        // Use these details to create a new profile
        printf('Hello %s!', $resourceOwnerDetails->getDisplayName());
    } catch (\Exception $e) {
        // Failed to get user details
        exit('Something went wrong: ' . $e->getMessage());
    }

    // Use this to interact with an API on the users behalf
    var_dump($token->getToken());
    # string(217) "CAADAppfn3msBAI7tZBLWg..."

    // Use this to get a new access token if the old one expires
    var_dump($token->getRefreshToken());
    # string(217) "CAADAppfn3msBAI7tZBLWg..."

    // Unix timestamp at which the access token expires
    var_dump($token->getExpires());
    # int(1436825866)
}

管理作用域

在创建您的Spotify授权URL时，您可以指定应用程序可能授权的状态和作用域。

$options = [
    'scope' => [
        \Dnklbgn\OAuth2\Client\Provider\SpotifyScope::USER_READ_PRIVATE->value,
        \Dnklbgn\OAuth2\Client\Provider\SpotifyScope::USER_READ_EMAIL->value,
    ],
];

$authUrl = $provider->getAuthorizationUrl($options);

如果都没有定义，提供商将使用内部默认值。在编写此文档时，以下作用域可用。

• 图片
  • ugc-image-upload (SpotifyScope::UGS_IMAGE_UPLOAD)
• Spotify Connect
  • user-read-playback-state (SpotifyScope::USER_READ_PLAYBACK_STATE)
  • user-modify-playback-state (SpotifyScope::USER_MODIFY_PLAYBACK_STATE)
  • user-read-currently-playing (SpotifyScope::USER_READ_CURRENTLY_PLAYING)
• 播放
  • app-remote-control (SpotifyScope::APP_REMOTE_CONTROL)
  • streaming (SpotifyScope::STREAMING)
• 播放列表
  • playlist-read-private (SpotifyScope::PLAYLIST_READ_PRIVATE)
  • playlist-read-collaborative (SpotifyScope::PLAYLIST_READ_COLLABORATIVE)
  • playlist-modify-private (SpotifyScope::PLAYLIST_MODIFY_PRIVATE)
  • playlist-modify-public (SpotifyScope::PLAYLIST_MODIFY_PUBLIC)
• 关注
  • user-follow-modify (SpotifyScope::USER_FOLLOW_MODIFY)
  • user-follow-read (SpotifyScope::USER_FOLLOW_READ)
• 收听历史
  • user-read-playback-position (SpotifyScope::USER_READ_PLAYBACK_POSITION)
  • user-top-read (SpotifyScope::USER_TOP_READ)
  • user-read-recently-played (SpotifyScope::USER_READ_RECENTLY_PLAYED)
• 收藏夹
  • user-library-modify (SpotifyScope::USER_LIBRARY_MODIFY)
  • user-library-read (SpotifyScope::USER_LIBRARY_READ)
• 用户
  • user-read-email (SpotifyScope::USER_READ_EMAIL)
  • user-read-private (SpotifyScope::USER_READ_PRIVATE)
• 开放访问
  • user-soa-link (SpotifyScope::USER_SOA_LINK)
  • user-soa-unlink (SpotifyScope::USER_SOA_UNLINK)
  • user-manage-entitlements (SpotifyScope::USER_MANAGE_ENTITLEMENTS)
  • user-manage-partner (SpotifyScope::USER_MANAGE_PARTNER)
  • user-create-partner (SpotifyScope::USER_CREATE_PARTNER)

检索Spotify用户信息

getResourceOwner()方法将返回一个\Dnklbgn\OAuth2\Client\Provider\SpotifyResourceOwner实例，该实例提供一些有用的getter方法来访问基本授权用户详情。

$resourceOwnerDetails = $provider->getResourceOwner($token);

// The country of the user, as set in the user's account profile
$country = $resourceOwnerDetails->getCountry();
var_dump($country);
// string(2) "ID"

// The name displayed on the user's profile
$displayName = $resourceOwnerDetails->getDisplayName();
var_dump($displayName);
// string(6) "dnkbgn"

// The user's email address, as entered by the user when creating their account
$email = $resourceOwnerDetails->getEmail();
var_dump($email);
// string(19) "dnklbgn@example.com"

// The user's explicit content settings
$explicitContent = $resourceOwnerDetails->getExplicitContent();
var_dump($explicitContent);
// array(2) {
//   ["filter_enabled"]=>
//   bool(false)
//   ["filter_locked"]=>
//   bool(false)
//}

// Known external URLs for this user
$externalUrls = $resourceOwnerDetails->getExternalUrls();
var_dump($externalUrls);
// array(1) {
//   ["spotify"]=>
//   string(44) "https://open.spotify.com/user/abcd0123456789"
// }

// Information about the followers of the user
$followers = $resourceOwnerDetails->getFollowers();
var_dump($followers);
// array(2) {
//   ["href"]=>
//   NULL
//   ["total"]=>
//   int(3)
// }

// A link to the Web API endpoint for this user
$href = $resourceOwnerDetails->getHref();
var_dump($href);
// string(47) "https://api.spotify.com/v1/users/abcd0123456789"

// The Spotify user ID for the user
$id = $resourceOwnerDetails->getId();
var_dump($id);
// string(14) "abcd0123456789"

// The user's profile image
$images = $resourceOwnerDetails->getImages();
var_dump($images);
// array(1) {
//   [0]=>
//   array(3) {
//     ["url"]=>
//     string(64) "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
//     ["height"]=>
//     int(300)
//     ["width"]=>
//     int(300)
//   }
// }

// The user's Spotify subscription level: "premium", "free", etc.
$product = $resourceOwnerDetails->getProduct();
var_dump($product);
// string(7) "premium"

// The object type: "user"
$type = $resourceOwnerDetails->getType();
var_dump($type);
// string(4) "user"

// The Spotify URI for the user
$uri = $resourceOwnerDetails->getUri();
var_dump($uri);
// string(27) "spotify:user:abcd0123456789"

刷新令牌

如果您的访问令牌已过期，您可以使用刷新令牌来刷新它们。

if ($accessToken->hasExpired()) {
    $refreshedAccessToken = $provider->getAccessToken(
        new \League\OAuth2\Client\Grant\RefreshToken(),
        ['refresh_token' => $accessToken->getRefreshToken()],
    );
}

贡献

欢迎贡献，并将得到充分认可。有关详细信息，请参阅CONTRIBUTING。

致谢

• Nikolay Kuzmin

许可

MIT许可（MIT）。有关更多信息，请参阅许可文件。