The PHP SDK v3.0 released earlier than expected!

The PHP SDK v3.0.0 was released yesterday!

It is originally planned that the PHP SDK v3.0 is to be released on 1 July 2010. This is the first time that I find Facebook is releasing item ahead of the schedule!

Personally, I think this move is made because of the recent Authentication Data issue. Facebook is sending out email advising Facebook developers that their applications or sites may be inadvertently allowing authentication data to be passed to 3rd parties and request us to fix the issue. However, many developers may be encountering this simply because they are using the PHP SDK.

If you are not aware of this issue, you can refer to my blog for the details, related article include

Anyway, it is good to see that Facebook is responding FAST on this issue by releasing a new version of the PHP SDK. Simply go to GitHub to get it.


What is new in this version?

According to Facebook,

The new PHP SDK (v3.0.0) is a major upgrade to the older one (v2.2.x):
- Uses OAuth authentication flows instead of our legacy authentication flow
- Consists of two classes. The first (class BaseFacebook) maintains the core of the upgrade, and the second one (class Facebook) is a small subclass that uses PHP sessions to store the user id and access token.

So, basically the new version simply addresses the authentication data issue by

Note: where can I download the older PHP SDK v2.2.x?? The latest one that I am aware of is v2.1.2-6. I even cannot find v2.2.x in GitHub.


Upgrading or Not?

According to Facebook,

If you are only using the PHP SDK for authentication, please upgrade now. If you are using the JavaScript SDK for login in conjunction with the PHP SDK, you will want to wait for the JavaScript SDK upgrade (coming in 4 weeks). Version 3.0.0 of the PHP SDK won’t cooperate with the current JavaScript SDK due to the cookie format changing.

In short, if you are using the JavaScript SDK for authentication, you have to wait.

I believe most of the canvas application should be using the PHP SDK for authentication and it should be OK to do the upgrade. The major issue would therefore be "how to upgrade".

In this series of tutorials, I will be discussing and telling you what you should note and take care of when doing the upgrade. Stay tuned for the update.