themattharris / tmhoauth
由 @themattharris 编写的 PHP OAuth 库
Requires
- php: >=5.3.0
- ext-curl: *
README
由 @themattharris 编写的 PHP OAuth 库。
免责声明:此项目正在开发中。请使用问题跟踪器报告您遇到的任何增强或问题。
目标
- 支持 OAuth 1.0A
- 使用授权头而不是查询字符串或 POST 参数
- 允许上传图片
- 提供足够的信息以协助调试
依赖项
此库已在 PHP 5.3+ 上进行测试,依赖于 CURL 和 hash_hmac。绝大多数主机提供商都包含这些库,并且使用 PHP 5.1+。
代码使用了 hash_hmac,该函数是在 PHP 5.1.2 中引入的。如果您的 PHP 版本低于此版本,您应该要求您的托管服务提供商进行更新。
关于安全和 SSL 的注意事项
版本 0.60 加强了库的安全性,并将 curl_ssl_verifypeer
默认设置为 true
。由于一些托管服务提供商不提供最新的证书根文件,现在它包含在这个存储库中。如果版本过时或者您更喜欢自己下载证书根文件,可以从以下网址获取:http://curl.haxx.se/ca/cacert.pem
如果您收到 http 响应代码 0,请检查 $tmhOAuth->response['error']
以查看问题所在。通常,代码 0 表示无法找到 cacert.pem,可以通过将 cacert.pem 放在 tmhOAuth 正在查找的位置(在 $tmhOAuth->response['error']
消息中指示)来修复,或者通过设置 $tmhOAuth->config['curl_cainfo']
和 $tmhOAuth->config['curl_capath']
值。将 $tmhOAuth->config['use_ssl']
设置为 false 不是 解决此问题的方法。
使用方法
这将在以后构建,但到目前为止,请查看示例存储库 https://github.com/themattharris/tmhOAuthExamples 以了解库的使用方法。每个示例都包含使用说明。
有关如何使用 composer 安装 tmhOAuth 的指导,请参阅 tmhOAuthExamples 项目。
关于旧版本用户的通知
从版本 0.8.0 开始,tmhUtilities 已不再包含。如果您发现它们很有用,请向我提交问题,我将为它们创建一个新的存储库。版本 0.8.0 还忽略 $tmhOAuth->config['v']
。如果您之前使用过,您应该在传递给 $tmhOAuth->url
的路径中指定 API 版本。
版本 0.7.3 之前,将具有相同值的头信息折叠到 $tmhOAuth->response['headers']
键中。从 0.7.3 开始,具有相同键的头信息将使用数组来存储其值。
如果您之前使用过版本 0.4,请注意实用函数现在已拆分到自己的文件中。在将版本 0.5+ 用于您的应用程序之前,请在本地上测试以确保您的代码不需要包含 tmhUtilities。
如果您在定义时将自定义 HTTP 请求头定义为 'key: value'
字符串,您现在应将其定义为 'key' => 'value'
对。
变更历史
现在已在 tmhOAuth 维基上发布 https://github.com/themattharris/tmhOAuth/wiki/Change-History
社区
许可证:Apache 2(见包含的LICENSE文件)
关注@tmhOAuth以接收发布更新,或寻求支持。在Twitter上关注我:@themattharris查看Twitter开发者资源:https://dev.twitter.com