themattharris/tmhoauth

由 @themattharris 编写的 PHP OAuth 库

0.8.4 2014-08-06 22:29 UTC

This package is not auto-updated.

Last update: 2024-09-14 11:50:46 UTC


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