README

什么是SocialProof？

SocialProof是用于从各种社交媒体平台的内部API获取关注者/粉丝的流畅接口。它使用Guzzle异步处理所有API请求，并在出现API异常/错误时捕获它们，并使用用户定义的默认值。

特性

处理凭证/配置的简单、流畅语法。
完全异步使用Guzzle的getAsync()。
API请求失败时，可定义默认值。
配置时的简单调试。
自动处理来自Twitter等API的OAuth。
易于扩展，所有PR都受到欢迎。❤️

当前平台

非常欢迎对其他平台的额外pull requests。请使用现有的 Providers作为示例。

需求

PHP >= 7.0
Composer

安装

通过Composer安装

composer require log1x/socialproof

使用

SocialProof使用非常简单，但缓存值和适当地存储它们以避免触达API限制/影响性能取决于最终用户。对于WordPress，一个示例是使用 Transients API，有效期每天24小时，并使用 Options API作为回退值，并在会话过期后API请求失败时使用->setDefault()。

Facebook

use SocialProof\SocialProof;

return SocialProof::social()
  ->facebook()
      ->setUsername('example')
      ->setToken('XXXXXXXXXXXXXXXXXXXXXXXX')
  ->get();

请在此生成Facebook的token。

Twitter

use SocialProof\SocialProof;

return SocialProof::social()
  ->twitter()
      ->setUsername('username')
      ->setConsumerKey('XXXXXXXXXXXXXXXXXXXXXXXX')
      ->setConsumerSecret('XXXXXXXXXXXXXXXXXXXXXXXX')
      ->setToken('XXXXXXXXXXXXXXXXXXXXXXXX')
      ->setTokenSecret('XXXXXXXXXXXXXXXXXXXXXXXX')
  ->get();

Instagram

use SocialProof\SocialProof;

return SocialProof::social()
  ->instagram()
      ->setToken('XXXXXXXXXXXXXXXXXXXXXXXX')
  ->get();

use SocialProof\SocialProof;

return SocialProof::social()
  ->pinterest()
      ->setUsername('username')
  ->get();

use SocialProof\SocialProof;

return SocialProof::social()
  ->linkedin()
      ->setUsername('username')
      ->setToken('XXXXXXXXXXXXXXXXXXXXXXXX')
  ->get();

配置

SocialProof::social()在通过您的社交凭证传递时接受各种配置。以下是一个使用Facebook的示例

use SocialProof\SocialProof;

return SocialProof::social()
  ->facebook()
      ->setUsername('example')
      ->setToken('XXXXXXXXXXXXXXXXXXXXXXXX')
      ->setDefault('No followers')
      ->setApi('https://graph.facebook.com')
      ->setEndpoint('/v2.7/')
      ->setTimeout(60)
      ->setDebug()
  ->get();

也有一个长格式语法，可以使用setCredentials($array)和setConfigs($array)或字符串使用setCredential($key, $value)和setConfig($key, value)通过数组传递凭证和配置。

use SocialProof\SocialProof;

return SocialProof::social()
  ->facebook()
      ->setCredentials([
        'username' => 'example',
        'token' => 'XXXXXXXXXXXXXXXXXXXXXXXX'
      ])
      ->setConfig('default', 'No Followers')
  ->get();

调试

由于SocialProof会捕获API错误、超时等，并返回默认值，因此您可以在初始设置期间使用->setDebug()来启用调试。

log1x / socialproof

维护者

详情