venturecraft/initialcon

创建一个类似GMail的头像,基于用户的初始字母和持久标识符(如电子邮件地址)。

0.1.2 2015-07-20 02:59 UTC

This package is auto-updated.

Last update: 2024-09-23 16:00:21 UTC


README

Initialcon示例 #1   Initialcon示例 #2   Initialcon示例 #3  

安装

推荐通过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

一切应该都很正常。

致谢

许可证

Initialcon在MIT许可证下发布。有关详细信息,请参阅捆绑的LICENSE文件。