PHP扩展之Web服务（一）——OAuth

一、概述及安装

此扩展提供 OAuth 消费方和提供方之间的绑定。OAuth 是一种建立在 HTTP 之上的授权协议，用于允许应用程序安全访问数据而无需存储用户名和密码。

PECL/oauth 需要 PHP 5.1 或更高版本，以及 ext/hash 和 ext/pcre 。

如果在构建时选择 PECL/oauth 则可选择性地需要 libcurl 。如果使用 libcurl 配置，则必须构建 HTTPS 支持。

安装此 PECL 扩展相关的信息可在手册中标题为 PECL 扩展的安装章节中找到。

二、使用范例

<?php$req_url = ’https://fireeagle.yahooapis.com/oauth/request_token’;$authurl = ’https://fireeagle.yahoo.net/oauth/authorize’;$acc_url = ’https://fireeagle.yahooapis.com/oauth/access_token’;$api_url = ’https://fireeagle.yahooapis.com/api/0.1’;$conskey = ’your_consumer_key’;$conssec = ’your_consumer_secret’;session_start();//  当 state=1 则下次请求应该包含一个 oauth_token 。//  如果没有则返回 0if(!isset($_GET[’oauth_token’]) && $_SESSION[’state’]==1) $_SESSION[’state’] = 0;try { $oauth = new OAuth($conskey,$conssec,OAUTH_SIG_METHOD_HMACSHA1,OAUTH_AUTH_TYPE_URI); $oauth->enableDebug(); if(!isset($_GET[’oauth_token’]) && !$_SESSION[’state’]) {$request_token_info = $oauth->getRequestToken($req_url);$_SESSION[’secret’] = $request_token_info[’oauth_token_secret’];$_SESSION[’state’] = 1;header(’Location: ’.$authurl.’?oauth_token=’.$request_token_info[’oauth_token’]);exit; } else if($_SESSION[’state’]==1) {$oauth->setToken($_GET[’oauth_token’],$_SESSION[’secret’]);$access_token_info = $oauth->getAccessToken($acc_url);$_SESSION[’state’] = 2;$_SESSION[’token’] = $access_token_info[’oauth_token’];$_SESSION[’secret’] = $access_token_info[’oauth_token_secret’]; } $oauth->setToken($_SESSION[’token’],$_SESSION[’secret’]); $oauth->fetch('$api_url/user.json'); $json = json_decode($oauth->getLastResponse()); print_r($json);} catch(OAuthException $E) { print_r($E);}?>三、相关函数oauth_get_sbs — 生成一个签名字符基串oauth_urlencode — 将 URI 编码为 RFC 3986 规范四、相关类及其成员函数

OAuth类

OAuth::__construct — 新建一个 OAuth 对象OAuth::__destruct — 析构函数OAuth::disableDebug — 关闭详细的调试OAuth::disableRedirects — 关闭重定向OAuth::disableSSLChecks — 关闭 SSL 检查OAuth::enableDebug — 启用详细调试OAuth::enableRedirects — 启用重定向OAuth::enableSSLChecks — 启用 SSL 检查OAuth::fetch — 获取一个 OAuth 受保护的资源OAuth::generateSignature — 生成一个签名OAuth::getAccessToken — 获取一个访问令牌OAuth::getCAPath — 获取 CA 信息OAuth::getLastResponse — 获取最后一次的响应OAuth::getLastResponseHeaders — 获取最后一次响应的头信息OAuth::getLastResponseInfo — 获取关于最后一次响应的 HTTP 信息OAuth::getRequestHeader — 生成 OAuth 头信息字符串签名OAuth::getRequestToken — 获取一个请求令牌OAuth::setAuthType — 设置授权类型OAuth::setCAPath — 设置 CA 路径和信息OAuth::setNonce — 为后续请求设置现时标志OAuth::setRequestEngine — 设置目标请求引擎OAuth::setRSACertificate — 设置 RSA 证书OAuth::setSSLChecks — 调整特定的SSL请求检查OAuth::setTimestamp — 设置时间戳OAuth::setToken — 设置令牌和 secretOAuth::setVersion — 设置 OAuth 版本

OAuthProvider 类

OAuthProvider::addRequiredParameter — 添加必需的参数OAuthProvider::callconsumerHandler — 调用 consumerNonceHandler 回调函数OAuthProvider::callTimestampNonceHandler — 调用 timestampNonceHandler 回调函数OAuthProvider::calltokenHandler — 调用 tokenNonceHandler 回调函数OAuthProvider::checkOAuthRequest — 检查一个 oauth 请求OAuthProvider::__construct — 新建一个 OAuthProvider 对象OAuthProvider::consumerHandler — 设置 consumerHandler 句柄回调函数OAuthProvider::generateToken — 生成一个随机令牌OAuthProvider::is2LeggedEndpoint — is2LeggedEndpointOAuthProvider::isRequestTokenEndpoint — 设置 isRequestTokenEndpointOAuthProvider::removeRequiredParameter — 移除一个必需的参数OAuthProvider::reportProblem — 报告问题OAuthProvider::setParam — 设置一个参数OAuthProvider::setRequestTokenPath — 设置请求令牌路径OAuthProvider::timestampNonceHandler — 设置 timestampNonceHandler 句柄回调函数OAuthProvider::tokenHandler — 设置 tokenHandler 句柄回调函数

OAuthException 类

OAuthException — OAuthException 类