萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

新浪微博 API 開發入門 (PHP):OAuth 2.0 用戶授權完整流程

基於新浪微博開放平台 (open.weibo.com) 的 PHP SDK 開發包,梳理 OAuth 2.0 授權碼模式完整流程,含關鍵坑點與代碼範例。

準備工作

  1. 註冊開發者帳號,創建應用,獲取 App Key (WB_AKEY) 與 App Secret (WB_SKEY)。
  2. 設定授權回調頁 (Redirect URI),如 https://yourdomain.com/callback.php。
  3. 下載 PHP SDK (舊版 weibo-oauth-class),或改用現代 Guzzle + 官方 API 文檔自行實作 (推薦)。

OAuth 2.0 授權碼模式三步驟

步驟 1:導向授權頁,獲取未授權 Request Token (舊版 SDK 術語,實為授權碼 code)

<?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;

步驟 2:用戶授權後,微博重導向回 callback.php

URL 會攜帶 ?oauth_token=xxx&oauth_verifier=yyy。

步驟 3:換取 Access Token (長效憑證)

<?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'];

核心坑點總結

  • Session 必須在步驟 1 存入 Request Token,步驟 3 取出配合 oauth_verifier 換 Access Token。缺此步驟是新手最常見失敗原因。
  • 回調域名必須與應用設定完全一致 (含 http/https、www、埠口)。
  • Access Token 長期有效 (除非用戶撤銷授權),存資料庫即可,不要每次請求都重新授權。
  • 調用 API 時實例化 WeiboClient 傳入 App Key/Secret + Access Token/Secret。

調用 API 範例:獲取公開時間線

$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 年代久遠,建議:

  • 用 Guzzle HTTP Client 直接呼叫 REST API (https://api.weibo.com/2/...)。
  • OAuth 流程參考 官方文檔 手寫,更透明可控。
  • 使用 league/oauth2-client 通用 OAuth2 客端庫,支援多提供者。
copyright © 萬盛學電腦網 all rights reserved