OAuth::getAccessToken()

(PECL OAuth >= 0.99.1)

获取一个访问令牌

说明

publicOAuth::getAccessToken(string $access_token_url[,string $auth_session_handle[,string $verifier_token]]): array

从服务提供者获取一个访问令牌、secret以及一些附带的响应参数。

参数

$access_token_url: 用于访问令牌 API 的 URL。
$auth_session_handle: 授权会话句柄，此参数在 OAuth 规范核心中没有任何引用，但可能被大的提供者实现。»参见 ScalableOAuth获取更多信息。
$verifier_token: 对于支持 1.0a 的服务提供者，当交换请求令牌和访问令牌时，必须传递$verifier_token。如果$verifier_token存在于$_GET或$_POST中，它将被自动传递，且调用者不需要指定一个$verifier_token（通常如果访问令牌在 oauth_callback URL 上被交换）。»参见 ScalableOAuth获取更多信息。

返回值

成功则返回一个包含解析过的 OAuth 响应的数组，失败则返回FALSE。

更新日志

版本	说明
1.0.0	以前失败时返回`NULL`，而不是`FALSE`。
0.99.9	新增`$verifier_token`参数

范例

Example #1 OAuth::getAccessToken()例子

<?php
try {
    $oauth = new OAuth(OAUTH_CONSUMER_KEY,OAUTH_CONSUMER_SECRET);
    $oauth->setToken($request_token,$request_token_secret);
    $access_token_info = $oauth->getAccessToken("https://example.com/oauth/access_token");
    if(!empty($access_token_info)) {
        print_r($access_token_info);
    } else {
        print "Failed fetching access token, response was: " . $oauth->getLastResponse();
    }
} catch(OAuthException $E) {
    echo "Response: ". $E->lastResponse . "\n";
}
?>

以上例程的输出类似于：

Array
(
    [oauth_token] => some_token
    [oauth_token_secret] => some_token_secret
)

参见

OAuth::getLastResponse() 获取最后一次的响应
OAuth::getLastResponseInfo() 获取关于最后一次响应的 HTTP 信息
OAuth::setToken() 设置令牌和 secret