リクエストトークンを取得する

# OAuth::getRequestToken

(PECL OAuth >= 0.99.1)

OAuth::getRequestToken — リクエストトークンを取得する

### 説明

public function OAuth::getRequestToken(string `$request_token_url`, string `$callback_url` = ?, string `$http_method` = ?): array

リクエストトークン、secret そして追加のレスポンスパラメータをサービスプロバイダから取得します。

### パラメータ

`request_token_url`
  リクエストトークン API の URL。
`callback_url`
  OAuth コールバック URL。`callback_url` に空の値を渡すと、"oob" に設定されて OAuth 2009.1 advisory を指すことになります。
`http_method`
  利用する HTTP メソッド。`GET` や `POST` など。

### 戻り値

成功した場合は OAuth レスポンスをパースした配列、失敗した場合は `false` を返します。

### 変更履歴

バージョン | 説明
--- | ---
PECL oauth 1.0.0 | 以前は、失敗したときに `false` ではなく `null` を返していました。
PECL oauth 0.99.9 | `callback_url` パラメータが追加されました。

### 例

例1 OAuth::getRequestToken() の例

    <?php
    try {
        $oauth = new OAuth(OAUTH_CONSUMER_KEY,OAUTH_CONSUMER_SECRET);
        $request_token_info = $oauth->getRequestToken("https://example.com/oauth/request_token");
        if(!empty($request_token_info)) {
            print_r($request_token_info);
        } else {
            print "Failed fetching request 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 情報を取得する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open