Laravel 生成 Gravatar 頭像地址的優雅姿式

Laravel Gravatar 擴展包提供了最簡單優雅的方式來生成 Gravatar 全球公認頭像地址。靈活方便的 API ，支持多鏈接配置，支持鏡像地址。

項目主頁：https://github.com/ElfSundae/...

若是以爲好用，請 Star

安裝

$ composer require elfsundae/laravel-gravatar

配置

雖然本擴展包不須要任何設置也能使用，可是爲了避免在代碼中硬編碼圖片尺寸等參數、以及使用鏡像地址（你懂的），因此建議使用配置文件來配置 Gravatar 鏈接 (connection)。

爲了性能，本擴展包不註冊 service provider ，因此須要手動拷貝配置文件到你的應用：

$ cp vendor/elfsundae/laravel-gravatar/config/gravatar.php config/gravatar.php

配置文件有很詳細的註釋，請自行閱讀。

在配置文件中你能夠爲你的應用配置多個 Gravatar 鏈接 (connection) ，除了 Gravatar 的圖片參數（詳見 https://gravatar.com/site/imp... ) 外，還能夠設置 url 鏡像地址。默認的 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

只有一個全局幫助函數： 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 參數爲 100
gravatar($email, 100);

// 使用 "avatar" 鏈接配置，並覆蓋 size 參數爲 100
gravatar($email, 'avatar', 100);
// 或者：
gravatar($email, 100, 'avatar');