venturecraft / initialcon
创建一个类似GMail的头像,基于用户的初始字母和持久标识符(如电子邮件地址)。
0.1.2
2015-07-20 02:59 UTC
Requires
- php: >=5.4.0
- intervention/image: 2.*
Requires (Dev)
- fzaninotto/faker: 1.2.*@dev
This package is auto-updated.
Last update: 2024-09-23 16:00:21 UTC
README
安装
推荐通过composer安装Initialcon。
只需为您项目创建一个composer.json
文件
{ "require": { "VentureCraft/initialcon": "*" } }
然后运行以下两个命令来安装它
$ wget https://getcomposer.org.cn/composer.phar $ php composer.phar install
现在您可以添加自动加载器(如果您的框架还没有为您这样做),您将可以使用这个库
<?php require 'vendor/autoload.php';
您完成了。
用法
图像以PNG格式生成,带有彩色背景和白色文本的初始字母。
字符串可以是电子邮件、IP地址、用户名、ID或其他在页面加载之间持久存在的字符串。这个字符串决定了图标背景的颜色,只要字符串不改变,它就会在页面加载之间持续存在。
生成initialcon
创建一个新的Initialcon
对象。
$initialcon = new Initialcon();
然后您可以生成并显示initialcon图像
$initialcon->displayImage('TS', 'tom@test.com');
或生成并获取图像数据
$imageData = $initialcon->getImageData('TS', 'tom@test.com');
或生成并获取准备用于集成到HTML img标签中的base 64图像uri。
$imageDataUri = $initialcon->getImageDataUri('HI', 'hello@test.com');
<img src="<?php echo $imageDataUri; ?>" alt="bar Initialcon" />
更改大小
默认大小为64像素。如果您想更改图像大小,只需添加一个次要参数。本例中为512 x 512像素。
$initialcon->displayImage('TS', 'tom@test.com', 512);
颜色
颜色会根据字符串哈希自动生成,但您可以通过添加第三个参数来指定颜色。
颜色可以是6个字符的十六进制数
$initialcon->displayImage('TS', 'tom@test.com', 64, 'A87EDF');
图像对象
您还可以获取图像对象以添加更多到最终图标中的操作(如圆角、不透明度等)。我们使用Intervention库进行图像创建,因此它的所有方法都可以供您使用。
$initialcon->getImageObject('TS', 'tom@test.com', 512);
这就完成了!
单元测试
要运行单元测试,您需要一个通过Composer安装的依赖项集
php composer.phar install
安装后,只需运行以下命令
phpunit
一切应该都很正常。
致谢
- 最初从Benjamin Laugueux的出色Identicon库(https://github.com/yzalis/Initialcon)fork而来
许可证
Initialcon在MIT许可证下发布。有关详细信息,请参阅捆绑的LICENSE文件。