README

通过用户名、文件或URL生成用户头像。

功能

• 保存为PNG格式
• 通过用户名生成头像
• 从文件或URL（仅http）生成头像
• 根据用户名自动选择背景颜色
• 文本对比色
• 字体样式和大小自定义
• 背景PNG纹理

依赖

• PHP 7
• PHP GD

安装

使用composer安装

composer require zertex/avatar-generator

或添加

"zertex/avatar-generator": "*"

到您的 composer.json 文件的require部分。

配置

$options = AvatarOptions::create()
			->setFont('path to ttf font')
			->setWidth(300)
			->setFontSize(200)
			->setTexturesFolder('path to textures folder')
			->setImagesFolder('path to generated images folder')
			->setImagesUrl('url to images folder')
			->setSalt('random salt');

• setFont - TTF字体路径
• setWidth - 头像图像文件宽度和高度。默认：300
• setFontSize - 字体大小。默认：200
• setTexturesFolder - 纹理文件夹路径。仅用于PNG纹理
• setImagesFolder - 图片文件夹路径。
• setImagesUrl - 生成完整链接到图片的URL
• setSalt - 新图像文件名中的随机文本

使用

通过用户名生成头像图像

$image_src = Avatar::init('John Smith', $options, [result file name])
			   ->username()
			   ->texture('TEXTURE_NAME')
			   ->text()
			   ->get_file_name();

从文件生成头像图像

$image_src = Avatar::init('John Smith', $options, [result file name])
			   ->file('/path/to/file')
			   ->texture('TEXTURE_NAME')
			   ->text()
			   ->get_file_name();

从URL生成头像图像

$image_src = Avatar::init('John Smith', $options, [result file name])
			   ->file('http://your-site.com/image.jpg')
			   ->texture('TEXTURE_NAME')
			   ->text()
			   ->get_file_name();

您可以通过链排除纹理或文本来排除它们

纹理

您可以使用带透明度的PNG纹理。每个纹理必须包含 2个文件（背面 & 白色）。其名称必须是

TEXTURE_NAME . '-' . COLOR . '.png'

• TEXTURE_NAME - 任意单词。在 texture() 方法中，您可以使用 TEXTURE_NAME 的数组进行随机
• COLOR - 必须是 black 或 white

屏幕截图

Yii2扩展

此处是Yii2头像生成扩展： https://github.com/zertex/yii2-avatar-generator

在这里您可以找到2个纹理和Play-Bold.ttf字体

示例

https://zertex.ru/yii2-avatar-generator