一、概述及安装
此扩展提供 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 。 // 如果没有则返回 0 if(!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 — 设置令牌和 secret
- OAuth::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 — is2LeggedEndpoint
- OAuthProvider::isRequestTokenEndpoint — 设置 isRequestTokenEndpoint
- OAuthProvider::removeRequiredParameter — 移除一个必需的参数
- OAuthProvider::reportProblem — 报告问题
- OAuthProvider::setParam — 设置一个参数
- OAuthProvider::setRequestTokenPath — 设置请求令牌路径
- OAuthProvider::timestampNonceHandler — 设置 timestampNonceHandler 句柄回调函数
- OAuthProvider::tokenHandler — 设置 tokenHandler 句柄回调函数
OAuthException 类
- OAuthException — OAuthException 类
- 本文固定链接: https://zxbcw.cn/post/1054/
- 转载请注明:必须在正文中标注并保留原文链接
- QQ群: PHP高手阵营官方总群(344148542)
- QQ群: Yii2.0开发(304864863)