此包尝试通过检查Google+和Gravatar来从电子邮件地址获取头像。

0.2.0 2017-02-27 19:01 UTC

This package is not auto-updated.

Last update: 2024-09-24 03:59:39 UTC


README

此包尝试通过检查PicasaWeb和Gravatar API从电子邮件地址获取头像。

需求

PHP 5.5及更高版本。

Composer

更新你的 composer.json

{
  "require": {
    "12-stars-media/avy-get": "0.2.*"
  }
}

然后执行 composer install

入门

使用PicasaWeb API

创建应用和API密钥以使用Google+ API。

  1. Google开发者控制台 上创建项目
  2. 启用Google+ API
  3. 创建公共API访问密钥

设置环境变量,以便AvyGet可以使用Google的API验证您。

  • API_GOOGLE_APP_NAME(您项目的或应用的名称)
  • API_GOOGLE_API_KEY(您在上述第3步中创建的API密钥)

基本用法

为每个需要个人资料图片的电子邮件创建一个新的实例

$avyGet = new AvyGet(
  'avyget@example.com', // Email address to find image for
  120                   // Desired image size in pixels (optional)
);

$avatar = $avyGet->url(); // Returns url for image

文档

实例化AvyGet

new AvyGet( string $email [, int $size = 200 ] [, array $services = [] ] );

只需要电子邮件,但您可以请求特定大小的头像,也可以修改用于查找头像的服务。

头像源服务

默认服务和优先级顺序是

protected $services = [
    'AvyGet\Services\Google',
    'AvyGet\Services\Gravatar',
];

可以通过扩展 AvyGet\Services\ProfilePhotoAbstract 并实现 AvyGet\Services\ImageUrlInterface 来创建更多服务。

方法

resize( int $size )

返回修改后的AvyGet实例(即它是可链的)。

$avyGet->resize(150)->url();

url()

返回由AvyGet实例化的url,如果没有为提供的电子邮件找到头像,则返回null。

$avyGet->url();

urlArray( array $sizes )

返回一个索引数组或关联数组,相对于提供的内容进行索引或关联 - 用适当的URL替换您的大小值。

$avyGet->urlArray([
  32,
  128,
  512
]);

/**
 * [
 *   'http://www.example.com/image?size=32',
 *   'http://www.example.com/image?size=128',
 *   'http://www.example.com/image?size=512',
 * ]
 */
$avyGet->urlArray([
  'small'  => 32,
  'medium' => 128,
  'large'  => 512,
]);

/**
 * [
 *   'small'  => 'http://www.example.com/image?size=32',
 *   'medium' => 'http://www.example.com/image?size=128',
 *   'large'  => 'http://www.example.com/image?size=512',
 * ]
 */

许可

AvyGet是开源软件,许可协议为MIT许可证