基於新浪微博開放平台 (open.weibo.com) 的 PHP SDK 開發包,梳理 OAuth 2.0 授權碼模式完整流程,含關鍵坑點與代碼範例。
https://yourdomain.com/callback.php。weibo-oauth-class),或改用現代 Guzzle + 官方 API 文檔自行實作 (推薦)。<?php
require_once 'weibo_oauth.php'; // SDK 入口
$oauth = new WeiboOAuth(WB_AKEY, WB_SKEY);
// 獲取臨時憑證 (舊版 SDK 叫 Request Token,實為授權頁參數)
$keys = $oauth->getRequestToken();
// 關鍵:必須存入 Session,回調時需用到
$_SESSION['oauth_keys'] = $keys;
// 產生授權 URL,第三參數為回調地址
$authUrl = $oauth->getAuthorizeURL($keys['oauth_token'], false, 'https://yourdomain.com/callback.php');
header('Location: ' . $authUrl);
exit;
callback.phpURL 會攜帶 ?oauth_token=xxx&oauth_verifier=yyy。
<?php
// callback.php
require_once 'weibo_oauth.php';
session_start();
$keys = $_SESSION['oauth_keys'] ?? null;
$verifier = $_GET['oauth_verifier'] ?? null;
if (!$keys || !$verifier) {
die('授權會話失效或參數缺失');
}
$oauth = new WeiboOAuth(
WB_AKEY,
WB_SKEY,
$keys['oauth_token'],
$keys['oauth_token_secret']
);
$accessToken = $oauth->getAccessToken($verifier); // 返回 ['oauth_token'=>..., 'oauth_token_secret'=>...]
// 關鍵:將 Access Token 存入資料庫,關聯本地用戶 ID
// $pdo->prepare('UPDATE users SET wb_token=?, wb_secret=? WHERE id=?')
// ->execute([$accessToken['oauth_token'], $accessToken['oauth_token_secret'], $userId]);
echo '授權成功!Access Token: ' . $accessToken['oauth_token'];
oauth_verifier 換 Access Token。缺此步驟是新手最常見失敗原因。WeiboClient 傳入 App Key/Secret + Access Token/Secret。$client = new WeiboClient(WB_AKEY, WB_SKEY, $token, $secret);
$msg = $client->public_timeline(); // 返回 JSON 解碼後的陣列
if (isset($msg['error_code'])) {
die("API 錯誤: {$msg['error']} (code: {$msg['error_code']})");
}
print_r($msg);
舊版 SDK 年代久遠,建議:
https://api.weibo.com/2/...)。league/oauth2-client 通用 OAuth2 客端庫,支援多提供者。