README

• 安装
• 注册包
• 使用
• 通过 user() 方法生成 gravatar url
• 通过 make() 方法生成 gravatar url
• 生成 HTM 头像代码

安装

将 Gravatar 添加到 composer.json 文件中

composer require artlabs/gravatar

使用 composer 安装此包。

$ composer update

注册包

将 Gravatar 服务提供者添加到 config/app.php 的配置中

'providers' => array(
	Artlabs\Gravatar\GravatarServiceProvider::class
),

使用

通过 user() 方法生成 gravatar url

使用默认设置生成头像非常简单，只需调用 user() 方法并传入用户邮箱作为参数

<?php
	// user email
	$email = "example@user.email";

	// create a gravatar object for specified email
 	$gravatar = Gravatar::user( $email );

	 // get gravatar url as a string
	$url = $gravatar->url();

?>

如果您想稍微自定义头像，可以使用一些额外的参数来设置，例如使用 size()、rating()、defaultImage() 等方法。

<?php
	// user email
	$email = "example@user.email";

	// create a gravatar object for specified email with additional settings
 	$gravatar = Gravatar::user( $email );

 	// Size in pixels, defaults to 80px [ 1 - 2048 ]
	$gravatar->size('220');

	// Maximum rating (inclusive) [ g | pg | r | x ]
	// defaults to 'g'
	$gravatar->rating('g');

	// Default imageset to use [ 404 | mm | identicon | monsterid | wavatar ]
	// You can also specify url to your own default avatar image
	// defaults to 'mm'
	$gravatar->defaultImage('mm');

    // set Gravatar to build urls with https [true = use https, false = ise http]
    // defaults to 'false'
    $gravatar->secured( true );

	// get gravatar url as a string
	$url = $gravatar->url();

?>

您也可以链式调用所有方法

<?php
 	$url = Gravatar::user( $email )->size('220')->rating('g')->defaultImage('mm')->url();
?>

通过 make() 方法生成 gravatar url

生成 gravatar url 的基本方法是仅调用 make() 方法并传入用户邮箱地址作为参数（所有其他参数将从默认值中加载）。

<?php
	// user email
	$email = "example@user.email";

	// create a gravatar object for specified email
 	$gravatar = Gravatar::make( $email );

	 // get gravatar url as a string
	$url = $gravatar->url();

?>

您也可以链式调用方法

<?php
	// to get url string
	$url = Gravatar::make( $email )->url();
?>

如果您想指定头像的大小或其他额外参数，可以通过将参数数组传递给 make() 方法来实现。

<?php
	// user email
	$email = "example@user.email";

	// create a gravatar object in specified size
 	$url = Gravatar::make( ['email' => $email, 'size' => 220] )->url();

	// create a gravatar object with some other additional parameters
 	$url = Gravatar::make( [
 		'email' => $email,
 		'size' => 220,
 		'defaultImage' => 'mm',
 		'rating' => 'g',
 	    'secured' => true
 	])->url();
?>

生成 HTM 头像代码

使用 Gravatar，您可以通过调用 url() 方法获取用户头像的 URL 字符串，也可以通过调用 html() 方法而不是 url() 来生成完整的 HTML 代码。

<?php
	// user email
	$email = "example@user.email";

	// create some Gravatar object
 	$gravatar = Gravatar::user( $email )->size('120');

	 // get gravatar <img> html code
	$html = $gravatar->html();
?>

如果您想对返回的 HTML 代码有更多的控制，可以向 html() 方法传递一些额外的 HTML 属性，例如

<?php
	$html = Gravatar::user( $email )->html( ['class' => 'avatar', 'id' => 'user123' ] );
?>