12-stars-media / avy-get
此包尝试通过检查Google+和Gravatar来从电子邮件地址获取头像。
0.2.0
2017-02-27 19:01 UTC
Requires
- php: >=5.5.0
- google/apiclient: 1.0.*@beta
- thomaswelton/gravatarlib: 0.1.*
Requires (Dev)
- mockery/mockery: ~0.9
- phpunit/phpunit: ~4.0
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。
- 在 Google开发者控制台 上创建项目
- 启用Google+ API
- 创建公共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许可证