README

安装

更新你的 composer.json 文件，将此包作为依赖项包含进来

"thomaswelton/laravel-gravatar": "~1.0"

此包支持 Laravel 5.5 中提供的 包发现 功能，因此如果你使用 Laravel 5.5，则无需再注册以下类。

通过在 config/app.php 文件中将它添加到 providers 数组中，注册 Gravatar 服务提供者。

Thomaswelton\LaravelGravatar\LaravelGravatarServiceProvider::class

通过在 config/app.php 文件中将它添加到 aliases 数组中，别名化 Gravatar 门面。

'aliases' => [
     'Gravatar' => Thomaswelton\LaravelGravatar\Facades\Gravatar::class
]

配置 - 可选

通过运行以下命令将配置文件复制到你的项目中

php artisan vendor:publish --provider="Thomaswelton\LaravelGravatar\LaravelGravatarServiceProvider"

默认图片

更新配置文件以指定要使用的默认头像大小以及当找不到 Gravatar 时返回的默认图片。

允许的默认值

• (string) <custom URL>：你选择的图片的 URL（公开可用，具有图像扩展名，且没有查询字符串）。
• (string) 404：如果没有与电子邮件哈希关联的图片，则不加载任何图片，而是返回 HTTP 404。
• (string) mm：一个简单的卡通风格的人物剪影轮廓（不随电子邮件哈希而变化）。
• (string) identicon：基于电子邮件哈希的几何图案。
• (string) monsterid：具有不同颜色、面部等特征的生成“怪物”。
• (string) wavatar：具有不同特征和背景的生成面部。
• (string) retro：酷炫的生成，8 位街机风格的像素化面部。

示例图片可以在 Gravatar 网站上查看。

内容评级

默认情况下，只会显示“G”级图片。您可以通过编辑配置文件中的 'maxRating' => 'g' 在系统范围内更改此系统，允许的值是

• g：适合所有网站和任何受众类型的显示。
• pg：可能包含粗俗的手势、穿着挑逗性的人、较轻的脏话或轻微的暴力。
• r：可能包含如严厉的脏话、强烈的暴力、裸露或硬性药物使用等内容。
• x：可能包含成人内容或极其令人不安的暴力。

可以通过更改调用 Gravatar::src 或 Gravatar::image 时的 $rating 参数来更改内容评级。

用法

Gravatar::exists($email)

返回一个布尔值，表示给定的 $email 是否有 Gravatar。

Gravatar::src($email, $size = null, $rating = null)

返回指定电子邮件地址的 Gravatar 的 https URL。可以可选地传递所需的整数大小。大小将包含在 1 - 512 之间，因为 Gravatar 不会返回大于 512 或小于 1 的大小。

<!-- Show image with default dimensions -->
<img src="{{ Gravatar::src('thomaswelton@me.com') }}">

<!-- Show image at 200px -->
<img src="{{ Gravatar::src('thomaswelton@me.com', 200) }}">

<!-- Show image at 512px scaled in HTML to 1024px -->
<img src="{{ Gravatar::src('thomaswelton@me.com', 1024) }}" width=1024>

Gravatar::image($email, $alt = null, $attributes = [], $rating = null)

返回用于 <img> 标签的 HTML

// Show image with default dimensions
echo Gravatar::image('thomaswelton@me.com');

// Show image at 200px
echo Gravatar::image('thomaswelton@me.com', 'Some picture', ['width' => 200, 'height' => 200]);

// Show image at 512px scaled in HTML to 1024px
echo Gravatar::image('thomaswelton@me.com', 'Some picture', ['width' => 1024, 'height' => 1024]);