新浪微博API開發簡介之PHP基礎篇-用戶授權

　　現在玩微博的人越來越多了，而關於微博的第三方應用開發也越來越多，自己在偶然間開始接觸了新浪微博API開發，新浪微博API開發的資源比較多，新浪微博提供了一個開發者的平台，網址是：http://open.weibo.com，它裡面有很全面的新浪微博開發的資料，包括開發者的使用和介紹，各種語言的API函數介紹文檔，SDK等多種資料。

　　自己在開發和學習的過程中，感覺雖然沒有太大難度，但還是有一些問題是需要我們注意的，今天就我在開發和學習的過程中，簡單的對利用PHP進行新浪微博API開發的內容進行一個整理和說明，

　　新浪微博API開發前的准備工作

　　首先到新浪微博開放平台下載基於PHP的SDK開發包，下載地址是：http://code.google.com/p/libweibo/downloads/detail?name=weibo-oauth-class-with-image-avatar-06-29.zip

　　下載完成後放到自己的開發環境中並解壓，在其中也包含了demo演示程序，我們可以參考其樣例程序進行編寫。

　　新浪微博API開發最重要的用戶授權過程

　　其實在開發過程中很多的問題都是集中在用戶授權這個階段，我開發的第三方應用，使用的是OAuth授權，關於OAuth授權的流程在新浪微博開放平台裡有很清晰完整的介紹，我們可以到http://open.weibo.com/wiki/Oauth去查看，我這裡從實例開發的角度進行介紹和說明。

　　1.首先獲取未授權的Request Token

 

$o = new WeiboOAuth( WB_AKEY , WB_SKEY  );
$keys = $o->getRequestToken();
//echo($keys['oauth_token'].' : '.$keys['oauth_token_secret']);

 

　　我們需要在新浪微博開放平台中注冊一個帳號，或直接使用我們的新浪微博帳號登錄，進入我的應用，然後按照提示創建屬於我們自己的第三方應用，創建完成之後我們可以得到兩個授權的App Key和App Secret值，這兩個值就是我們開發應用的關鍵。

　　得到授權值後，我們就可以利用上面的代碼獲得未授權的Request Token值了，它們會保存在$key數組變量中。

　　2.然後請求用戶授權Token

 

$_SESSION['keys'] = $keys;
$aurl = $o->getAuthorizeURL( $keys['oauth_token'] ,false , 'http://localhost/callback.php');

 

　　得到未授權的Request Token值後，我們就利用上面的代碼可以開始准備去新浪微博授權頁面進行授權，$aurl就是授權鏈接頁面，我們得到$aurl後就可以利用 header()直接跳轉到該授權頁面，然後用戶輸入新浪微博帳號和密碼進行授權，授權完成後，自動跳回你在最後一個參數裡面設置的回調頁面：http://localhost/callback.php，該鏈接你可以設置為上一個頁面，這樣授權完成之後就會自動又跳轉回去了。

　　需要注意的是設置session的keys的值是必須的，它在下面獲取到授權的Access Token中是需要用到的。很多的朋友可能會參考其開放平台上面的說明來進行授權時，可發現總是出錯，一般都是這個問題，你並未設置session的 keys值，在下面當然取不到Access Token的值了，這個一定要記住了。

　　3.最後得到用戶授權的Access Token

 

$o = new WeiboOAuth( WB_AKEY ,
                     WB_SKEY ,
                     $_SESSION['keys']['oauth_token'] ,
                     $_SESSION['keys']['oauth_token_secret']  );

$last_key = $o->getAccessToken(  $_REQUEST['oauth_verifier'] ) ;
echo($last_key['oauth_token']);

 

　　上面的代碼就最終獲得了用戶授權的Access Token，共兩個值，它們保存在$last_key數組變量裡面，我們也可以看到，後面的兩個參數就是前面我們設置的session值。到此就基本完成了，這就是新浪微博用戶授權的一個完整的過程。

　　授權完成後的工作

　　在授權完成之後，我們就可以開始調用新浪微博提供的各類API函數接口進行實際應用的開發了，在這裡我就獲取最新微博記錄這個接口進行一個簡單說明，其他都類似。

　　獲取最新新浪微博信息的API接口函數是：public_timeline()，樣例代碼看下面：

 

 

//獲取前20條最新更新的公共微博消息
$c = new WeiboClient( WB_AKEY ,
                      WB_SKEY ,
                      $oauth_token ,
                      $oauth_token_secret  );

$msg  = $c->public_timeline();
if ($msg === false || $msg === null){
 echo "Error occured";
 return false;
}
if (isset($msg['error_code']) && isset($msg['error'])){
 echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
 return false;
}
print_r($msg);

 

　　通常我們在得到用戶授權的Access Token值之後，就把它們保存在我們的用戶表中，與我們的應用中的帳號進行對應，之後我們在調用新浪微博各api接口時就不用每次都去認證了。

　　上面的代碼很簡單，實例化WeiboClient對象，然後直接調用接口函數public_timeline就可以得到返回的信息，如果沒有錯誤的話。通常新浪微博api接口返回的數據格式一般為Json格式或xml格式，而我們在此是用php進行開發，則使用Json格式的數據就有先天的優勢，如果返回Json格式數據的話，直接使用php函數json_decode()就可以轉換為php常用的array數組格式了。

　　來源：紅心草博客

　　原文地址：http://www.hongxincao.com/archives/579.html