README

安装

首先，通过命令行使用 Composer 拉取此包

composer require creativeorange/gravatar ~1.0

或者将以下内容添加到您的 composer.json 文件中，并运行 composer update。

"require": {
    "creativeorange/gravatar": "~1.0"
}

然后，在 app/config/app.php 中包含服务提供者（Laravel 5.3 或以下版本）。

'providers' => [
    'Creativeorange\Gravatar\GravatarServiceProvider'
];

如果使用 Laravel 5.4，则在 config/app.php 中包含服务提供者

'providers' => [
    Creativeorange\Gravatar\GravatarServiceProvider::class
];

如果您想使用外观，请将以下内容添加到 app/config/app.php 的底部。为了方便起见，将外观别名也添加到同一文件的底部

'aliases' => [
    'Gravatar' => 'Creativeorange\Gravatar\Facades\Gravatar',
];

如果您使用 Laravel 5.4 或更高版本，请按照以下方式添加，添加到 config/app.php

'aliases' => [
    'Gravatar' => Creativeorange\Gravatar\Facades\Gravatar::class,
];

最后，通过运行 php artisan vendor:publish 命令发布配置

用法

在您的控制器或视图中，您可以使用

    Gravatar::get('[email protected]');

这将返回指定电子邮件地址的 Gravatar 图片的 URL。如果不存在 Gravatar，将返回一个占位符图片的 URL。您可以在配置选项 fallback 中设置占位符的类型。有关更多信息，请访问 gravatar.com

或者，您可以使用以下方式检查 Gravatar 图片是否存在

    Gravatar::exists('[email protected]');

这将返回一个布尔值（true 或 false）。

或者，您可以通过回退方法传递一个自定义图片的 URL

    Gravatar::fallback('http://urlto.example.com/avatar.jpg')->get('[email protected]');

配置

您可以为应用程序内使用创建不同的配置组，并将组名作为第二个参数传递给 get 方法

在 config/gravatar.php 中有一个默认组，当您没有指定第二个参数时将使用此组。

如果您想添加更多组，请自由编辑 config/gravatar.php 文件。例如

return array(
	'default' => array(
		'size'   => 80,
		'fallback' => 'mm',
		'secure' => false,
		'maximumRating' => 'g',
		'forceDefault' => false,
		'forceExtension' => 'jpg',
	),
	'small-secure' => array (
	    'size'   => 30,
	    'secure' => true,
	),
	'medium' => array (
	    'size'   => 150,
	)
);

然后您可以使用以下语法

Gravatar::get('[email protected]', 'small-secure'); // will use the small-secure group
Gravatar::get('[email protected]', 'medium'); // will use the medium group
Gravatar::get('[email protected]', 'default'); // will use the default group
Gravatar::get('[email protected]'); // will use the default group

或者，您也可以直接作为内联选项传递一个数组作为第二个参数。因此，您不是传递配置键，而是传递一个数组，该数组将与默认组合并

Gravatar::get('[email protected]', ['size'=>200]);