前言
Gravatar頭像已經(jīng)成為了博客、論壇等一種非常流行的通用頭像,不管是Wordpress還是Z-Blog、Typecho、Emlog等,留言或者登錄注冊等都支持Gravatar頭像,Laravel Gravatar 擴展包提供了最簡單優(yōu)雅的方式來生成 Gravatar 全球公認(rèn)頭像地址。靈活方便的 API ,支持多連接配置,支持鏡像地址。
項目主頁:https://github.com/ElfSundae/laravel-gravatar
安裝
$ composer require elfsundae/laravel-gravatar
配置
雖然本擴展包不需要任何設(shè)置也能使用,但是為了不在代碼中硬編碼圖片尺寸等參數(shù)、以及使用鏡像地址(你懂的),所以建議使用配置文件來配置 Gravatar 連接 (connection)。
為了性能,本擴展包不注冊 service provider ,所以需要手動拷貝配置文件到你的應(yīng)用:
$ cp vendor/elfsundae/laravel-gravatar/config/gravatar.php config/gravatar.php
配置文件有很詳細(xì)的注釋,請自行閱讀。
在配置文件中你可以為你的應(yīng)用配置多個 Gravatar 連接 (connection) ,除了 Gravatar 的圖片參數(shù)(詳見 https://en.gravatar.com/site/implement/images/) 外,還可以設(shè)置 url 鏡像地址。默認(rèn)的 connection 名稱是 default 。
配置示例:
'default' => [
'url' => 'https://gravatar.cat.net/avatar',
'size' => 120,
],
'small' => [
'url' => 'https://gravatar.cat.net/avatar',
'size' => 40,
],
'large' => [
'url' => 'https://gravatar.cat.net/avatar',
'size' => 460,
],
API
只有一個全局幫助函數(shù): gravatar()
/**
* Generate Gravatar avatar URL for the given email address.
*
* @param string $email Email or email hash
* @param string|int $connection Connection name or image size
* @param string|int $size Connection name or image size
* @return string
*/
function gravatar($email, $connection = 'default', $size = null)
使用示例
// 為 email 生成頭像地址,使用 "default" 連接配置
gravatar('foo@example.com');
// 為 email 的 MD5 哈希值生成頭像地址,使用 "default" 連接配置
gravatar('b48def645758b95537d4424c84d1a9ff');
// 使用 "large" 連接配置
gravatar($email, 'large');
// 使用 "default" 連接配置,并覆蓋 size 參數(shù)為 100
gravatar($email, 100);
// 使用 "avatar" 連接配置,并覆蓋 size 參數(shù)為 100
gravatar($email, 'avatar', 100);
// 或者:
gravatar($email, 100, 'avatar');
總結(jié)
以上就是這篇文章的全部內(nèi)容了,希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,如果有疑問大家可以留言交流,謝謝大家對腳本之家的支持。