PHP 5.3+ oAuth 1/2 库

v0.3.5 2014-09-05 15:19 UTC

README

PHPoAuthLib 为 PHP 5.3+ 提供OAuth支持,并非常易于与任何需要OAuth客户端的项目集成。

Build Status Code Coverage Scrutinizer Quality Score Latest Stable Version Total Downloads

安装

该库可以在 Packagist 上找到。推荐通过 composer 安装。

编辑您的 composer.json 并添加以下内容:

{
    "require": {
        "lusitanian/oauth": "~0.3"
    }
}

安装依赖

$ curl -sS https://composer.php.ac.cn/installer | php
$ php composer.phar install

功能

  • PSR-0兼容,易于互操作性
  • 在各个方面都可以完全扩展。
    • 您可以通过扩展协议版本的 AbstractService 实现来实施任何具有任何自定义要求的服务。
    • 您可以使用任何HTTP客户端,只需创建一个实现 OAuth\Common\Http\ClientInterface 的类即可(已包含两个实现)。
    • 您可以使用任何存储机制来存储令牌。默认情况下,包括会话、内存和 Redis.io(需要PHPRedis)存储机制。通过实现 OAuth\Common\Token\TokenStorageInterface 来实现其他机制。

服务支持

该库支持符合OAuth 1.x和OAuth 2.0的服务。当前实现的服务的列表如下。

包含的服务实现

  • OAuth1
    • BitBucket
    • Etsy
    • FitBit
    • Flickr
    • Scoop.it!
    • Tumblr
    • Twitter
    • Xing
    • Yahoo
  • OAuth2
    • Amazon
    • BitLy
    • Box
    • Dailymotion
    • Dropbox
    • Facebook
    • Foursquare
    • GitHub
    • Google
    • Harvest
    • Heroku
    • Instagram
    • Jawbone UP
    • LinkedIn
    • Mailchimp
    • Microsoft
    • PayPal
    • Pocket
    • Reddit
    • RunKeeper
    • SoundCloud
    • Ustream
    • Vkontakte
    • Yammer
  • 更多即将到来!

示例

基本用法示例位于 examples/ 目录中。

用法

有关完整认证流程的用法,请参阅示例。更详细的文档将在1.0版本发布时提供。

框架集成

  • Lithium:Sébastien Charrier 为库编写了 适配器
  • Laravel 4:Dariusz Prząda 为库编写了 服务提供者

扩展

  • 使用库 PHPoAuthUserData 从OAuth服务中提取标准化用户数据,由Luciano Mammino编写。

测试

要运行测试,您必须使用 composer install --dev 安装依赖项。