PHP Last.fm API

Update: version 0.2 - details

I've been working on a simple set of classes so that people can use the Last.fm API in PHP without coding it all themselves.

There is currently no documentation but there are examples for each supported API method in the examples folder of the download.

It is licenced under the MIT open source license and released on SF.net so you can use it in basically any way you want as long as you give credit to the project for providing the classes (and not saying you wrote it yourself).

You can get the alpha release from the sf.net project page and the website.

Have fun with the classes and show me what you make in the last.fm group I setup.

Useful Links:

Project Website - http://phplastfmapi.sourceforge.net/
SF.net Project Page - http://sourceforge.net/projects/phplastfmapi/
Last.fm Group - http://www.last.fm/group/PHP+Last.fm+API/
SVN Browser - http://phplastfmapi.svn.sourceforge.net/viewvc/phplastfmapi/
SVN Access Documentation - http://sourceforge.net/svn/?group_id=236702

Edit: Could a staff member change the download link for the class in the API documentation to the project website please. Thank you :)

It's hand coded but the code for every method is a copy and paste job at the minute. I need to make the code reused a bit more to save space and make it easier to maintain.

I've never really messed with XSD's really and I'd have no idea what to use them for. I'm assuming though it could be used to autogenerate classes that process the XML returned from the Last.fm API. Am I somewhere close?

Thank you for the link, I'll put a link to your project when I update the website to something nice. At the minute It's just bare HTML with no CSS at all :S

Matt

It didn't take all that long to code in the end. It was quick once I got a set layout for each of the methods.

I've tidied up some of the code in the SVN version now by putting all the error related code into the base class. Not sure if it'll speed things up but it will make maintaining the code easier.

maybe you should send joanofarctan a PM for a link on API downloads page...
I think many people can make use from your lib, so why not PM him? And the merchandise is really cool stuff btw(I won't say what, as it's a secret to be kept :P )...

lotrgamemast, many thanks for putting this together.

Version 0.2 has been released. It added support for all the write methods of the API as well as the 2 new methods that came out recently. Also included are 2 different sample applications; one which shows you which staff memember you are most like and another which finds the word that best describes a users musical taste.

Please note that it won't be a drop in replacement when upgrading as the way in which you call all of the methods has been changed. Take a look at the examples to see how to do it now.

Enjoy!!!!!

For most of the methods you only need the API key. However if the method required authentication you need all the different bits.

The auth.txt is simply a way for the examples to work. You wouldn't use it this way in an actual application.

To get the auth for a non-authenticated method (artist.getInfo, album.getTopTags etc) you should have code this this:

$authVars = array(
'apiKey' => YOURAPIKEYHERE
);
$auth = new lastfmApiAuth('setsession', $authVars);

$apiClass = new lastfmApi();
$artistClass = $apiClass->getPackage($auth, 'artist');

You can then use the artistClass in the way shown in the examples.

If the method requires full authentication though you'll need to do it slightly differently:

$authVars = array(
'apiKey' => 'fa3af76b9396d0091c9c41ebe3c63716',
'secret' => 'f7df7cd6acf957521012f7a5f257d116',
'token' => $_GET['token']
);

$auth = new lastfmApiAuth('getsession', $authVars);

From this you will get all of the 5 variables that are written to auth.txt. However in a normal application you might want to store these in the database.

I need to make the example a bit clearer and start working on the documentation to help people out a bit with using the API. Give me a few weeks.

Hope this helped a bit!

@lotrgamemast: This looks good. I've just updated the link on the downloads page so you should see that change on the site today. Some code usage examples in the documentation would be great.

Thanks :)

I am unclear of the auth.txt format. I think it is the following:

api Key
secret Key
username
session Key
subscrber

with each data item on a separate line without any key=value identification. So on the username line I would just have bhogsett.

Is this correct?

Are the items quoted? I assume not. Right?

What is the difference between username and subscriber?

Thanks.

Bill Hogsett

In case if I want to get the biography of a band in Portuguese? What should I do?
Thanks for advance.

version 0.7
user.php
line 152
'You must include artist variable in the call for this method'
shouldn't be there 'user' instead of 'artist'?

Is this API still up to date?

I can't get the auth example to work. I've updated the api key and the secret to use my own key and secret, but all of the vars are still coming up blank.