README

根据用户名的首字母显示独特的头像。易于使用，并提供大量选项供您扩展。

安装

从composer中要求并开始使用它！

composer require fabian-tomischka/php-avatar-generator

使用

使用一行简单的代码快速开始

use Fabito\AvatarGenerator\Avatar;

$generator = new Avatar();
$avatar = $generator->name('Fabian Tomischka')->toJpeg();

您也可以使用字符串而不是给定的名称。但是，当提供字符串时，它将忽略任何给定的空格，并且始终直接从字符串中获取字符。

// Will result in Fa on the avatar instead of FT
$avatar = $generator->string('Fabian Tomischka')->toJpeg();

您还可以访问底层的图像管理器或画布，如果您需要的话

$manager = $generator->getImageManager();
$canvas = $generator->name('Fabian Tomischka')->getImageCanvas();

自定义

该软件包提供了多种调整和调整设置的方法。

driver('driver')

用于生成图像的驱动程序。目前支持：gd和imagick。默认：gd

$avatar = $generator->driver($generator::DRIVER_IMAGICK)->toBase64();

height('px'), width('px'), size('px'), dimensions('width', 'height')

更改头像的尺寸。通常大小即可完成任务。默认：100px

$avatar = $generator->size(100)->toBase64();

backgroundColor('color')

如果您不想使用软件包提供的默认颜色，可以在此处手动设置颜色

$avatar = $generator->backgroundColor('#000000')->toBase64();

fontColor('color')

更改字体颜色。默认：#F7F7F7

$avatar = $generator->fontColor('#000000')->toBase64();

fontSize('px')

更改头像上的字体大小。默认：42px

$avatar = $generator->fontSize(42)->toBase64();

length('int')

如果您需要头像上有更少或更多的字符。默认：2

// Output: F
$avatar = $generator->name('Fabian Tomischka')->length(1)->toBase64();
$avatar = $generator->string('FT')->length(1)->toBase64();

加载自定义字体

默认情况下，该软件包附带预安装的OpenSans Light和Regular字体。它们通常可以完成任务。如果您想更改字体，可以通过调用字体方法并提供新字体的路径来实现。

$avatar = $generator->font('/dir/to/the/font.ttf')->name('Fabian Tomischka')->toBase64();

确保字体可用为TTF格式！

获取图像数据

为了方便访问，该软件包提供了多个直接方法来访问不同格式的图像。

$avatar = $generator->name('Fabian Tomischka')->toBase64(); // Base 64
$avatar = $generator->name('Fabian Tomischka')->toPng(); // PNG
$avatar = $generator->name('Fabian Tomischka')->toJpeg(); // JPEG
$avatar = $generator->name('Fabian Tomischka')->toWebp; // WebP

如上所述，如果您需要访问底层的管理器或图像，您可以通过以下方式访问它们：

$manager = $generator->getImageManager();
$canvas = $generator->name('Fabian Tomischka')->getImageCanvas();

圆角头像

该软件包可能提供生成圆角头像的选项。

$avatar = $generator->rounded()->name('Fabian Tomischka')->toBase64();

但是，我强烈建议使用CSS中的border radius来显示您的头像作为圆形。生成圆角头像将始终导致较低的质量。

要求

• PHP 7.1.7或更高版本
• Intervention/Image 2.4或更高版本
• Imagick扩展（如果您不使用默认的GD）