LookupHandler
extends BaseHandler
in package
Table of Contents
Properties
- $baseUrl : string
- $client : Client
- $credentialService : LastFmCredentialService|null
- $sessionKey : string|null
Methods
- __construct() : mixed
- album() : array<string|int, mixed>
- artist() : array<string|int, mixed>
- artistSimilar() : array<string|int, mixed>
- artistTags() : array<string|int, mixed>
- artistTopAlbums() : array<string|int, mixed>
- artistTopTracks() : array<string|int, mixed>
- setCredentialService() : void
- Set the credential service for automatic session management
- setSessionKey() : void
- Manually set session key (overrides automatic detection)
- track() : array<string|int, mixed>
- trackSimilar() : array<string|int, mixed>
- trackTags() : array<string|int, mixed>
- buildQueryParams() : array<string|int, mixed>
- Build query parameters with automatic session key injection
- getSessionKey() : string|null
- Get session key for authenticated requests
- hasValidCredentials() : bool
- Check if current user has valid credentials
- makeRequest() : array<string|int, mixed>
- Make synchronous API request with error handling
- makeRequestAsync() : PromiseInterface
- Make asynchronous API request returning a promise
- requireAuthentication() : bool
- Require authenticated session for the request
Properties
$baseUrl read-only
protected
string
$baseUrl
$client read-only
protected
Client
$client
$credentialService
protected
LastFmCredentialService|null
$credentialService
= null
$sessionKey
protected
string|null
$sessionKey
= null
Methods
__construct()
public
__construct(Client $client, string $baseUrl) : mixed
Parameters
- $client : Client
- $baseUrl : string
album()
public
album(string $artistName, string $albumName[, string|null $mbid = null ]) : array<string|int, mixed>
Parameters
- $artistName : string
- $albumName : string
- $mbid : string|null = null
Return values
array<string|int, mixed>artist()
public
artist(string $artistName[, string|null $mbid = null ]) : array<string|int, mixed>
Parameters
- $artistName : string
- $mbid : string|null = null
Return values
array<string|int, mixed>artistSimilar()
public
artistSimilar(string $artistName[, string|null $mbid = null ][, int $limit = 50 ]) : array<string|int, mixed>
Parameters
- $artistName : string
- $mbid : string|null = null
- $limit : int = 50
Return values
array<string|int, mixed>artistTags()
public
artistTags(string $artistName[, string|null $mbid = null ]) : array<string|int, mixed>
Parameters
- $artistName : string
- $mbid : string|null = null
Return values
array<string|int, mixed>artistTopAlbums()
public
artistTopAlbums(string $artistName[, string|null $mbid = null ][, int $limit = 50 ]) : array<string|int, mixed>
Parameters
- $artistName : string
- $mbid : string|null = null
- $limit : int = 50
Return values
array<string|int, mixed>artistTopTracks()
public
artistTopTracks(string $artistName[, string|null $mbid = null ][, int $limit = 50 ]) : array<string|int, mixed>
Parameters
- $artistName : string
- $mbid : string|null = null
- $limit : int = 50
Return values
array<string|int, mixed>setCredentialService()
Set the credential service for automatic session management
public
setCredentialService(LastFmCredentialService $credentialService) : void
Parameters
- $credentialService : LastFmCredentialService
setSessionKey()
Manually set session key (overrides automatic detection)
public
setSessionKey(string|null $sessionKey) : void
Parameters
- $sessionKey : string|null
track()
public
track(string $artistName, string $trackName[, string|null $mbid = null ]) : array<string|int, mixed>
Parameters
- $artistName : string
- $trackName : string
- $mbid : string|null = null
Return values
array<string|int, mixed>trackSimilar()
public
trackSimilar(string $artistName, string $trackName[, string|null $mbid = null ][, int $limit = 50 ]) : array<string|int, mixed>
Parameters
- $artistName : string
- $trackName : string
- $mbid : string|null = null
- $limit : int = 50
Return values
array<string|int, mixed>trackTags()
public
trackTags(string $artistName, string $trackName[, string|null $mbid = null ]) : array<string|int, mixed>
Parameters
- $artistName : string
- $trackName : string
- $mbid : string|null = null
Return values
array<string|int, mixed>buildQueryParams()
Build query parameters with automatic session key injection
protected
buildQueryParams(array<string|int, mixed> $params) : array<string|int, mixed>
Parameters
- $params : array<string|int, mixed>
Return values
array<string|int, mixed>getSessionKey()
Get session key for authenticated requests
protected
getSessionKey() : string|null
Return values
string|nullhasValidCredentials()
Check if current user has valid credentials
protected
hasValidCredentials() : bool
Return values
boolmakeRequest()
Make synchronous API request with error handling
protected
makeRequest(array<string|int, mixed> $params) : array<string|int, mixed>
Parameters
- $params : array<string|int, mixed>
Return values
array<string|int, mixed>makeRequestAsync()
Make asynchronous API request returning a promise
protected
makeRequestAsync(array<string|int, mixed> $params) : PromiseInterface
Parameters
- $params : array<string|int, mixed>
Return values
PromiseInterfacerequireAuthentication()
Require authenticated session for the request
protected
requireAuthentication() : bool