PHPackages                             wuchienkun/laravel-identicon - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. wuchienkun/laravel-identicon

ActiveLibrary[Utility & Helpers](/categories/utility)

wuchienkun/laravel-identicon
============================

Identicon generator for Laravel.

07PHPCI failing

Since May 31Pushed 5y ago1 watchersCompare

[ Source](https://github.com/2015WUJI01/laravel-identicon)[ Packagist](https://packagist.org/packages/wuchienkun/laravel-identicon)[ RSS](/packages/wuchienkun-laravel-identicon/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (1)Used By (0)

Identicon 生成器 Laravel 版
=======================

[](#identicon-生成器-laravel-版)

本项目源自于 [yzalis/identicon](https://github.com/yzalis/Identicon)，它是一个 PHP 版的 Identicon 生成器，这个项目很棒，很多人都喜欢它，我不想侵权，但是它很久没更新了，我修复了一些错误并提交了 PR，但暂未得到合并。因此我临时做了一个 Laravel 版的 Identicon，如果可以的话，希望大家可以给源项目 [yzalis/identicon](https://github.com/yzalis/) 一个 star ⭐️。

---

**Identicon** 是一个基于字符串生成一个 [identicon](http://en.wikipedia.org/wiki/Identicon) 图像的库。

以下是一些精彩的输出例子！

[![Identicon example #1](doc/benjaminAtYzalisDotCom.png)](doc/benjaminAtYzalisDotCom.png) [![Identicon example #2](doc/Benjamin.png)](doc/Benjamin.png) [![Identicon example #3](doc/8.8.8.8.png)](doc/8.8.8.8.png) [![Identicon example #4](doc/8.8.4.4.png)](doc/8.8.4.4.png) [![Identicon example #5](doc/yzalis.png)](doc/yzalis.png)

安装
--

[](#安装)

推荐通过 composer 安装 Identicon。

Step 1. 在你的项目中引入本库：

```
composer require wuchienkun/laravel-identicon
```

Step 2. 发布配置文件：

```
php artisan vendor:publish --tag=laravel-identicon
```

配置
--

[](#配置)

发布配置文件后，可以在项目根目录的 `config` 文件夹中找到 `identicon.php`：

在这里可以选择默认的 Identicon Generator，默认使用的是 `imagick`。可选项有：`imagick`（需要安装 imagick 拓展），`gd`，`svg`。

```
'generator' => env('IDENTICON_GENERATOR', 'imagick')
```

可以在配置文件中修改 可以在 .env 文件中修改，例如：

```
IDENTICON_GENERATOR=gd
```

> 优先推荐 imagick, 其次推荐小尺寸使用 gd, 大尺寸使用 svg

使用
--

[](#使用)

> 注意：
>
> 1. 生成的图像都是透明背景的 PNG 格式。
> 2. 字符串可以是邮箱，IP 地址，用户名，ID 或者其他的东西。

在 IdenticonServiceProvider 中已经注册了 identicon 单例，因此可以使用 `app('identicon')` 来获取 Identicon 实例。另外也注册了 Identicon Facade，也可以通过依赖注入的方式使用 Identicon。

### 获取 Identicon 实例

[](#获取-identicon-实例)

在 Laravel 中有 3 种方式获取 Identicon 实例：

```
// 1. 通过容器获取单例
app('identicon')->getImageDataUri('foo');
```

```
// 2. 通过 Facade 获取单例
\Wuchienkun\Identicon\Facades\Identicon::getImageDataUri('foo');
```

```
// 3. 依赖注入
public function index(\Wuchienkun\Identicon\Identicon $identicon)
{
    $identicon->getImageDataUri('foo');
    ...
}
```

### 1. getImageDataUri（获取图像 URI）

[](#1-getimagedatauri获取图像-uri)

```
$identicon->getImageDataUri('foo');
```

得到的是一个 base64 格式的图片（例如：`data:image/png;base64,iVBORw0KGg...`），可以直接在 img 标签中使用：

```

```

### 2. 修改图像大小

[](#2-修改图像大小)

默认的大小是 64 像素。如果你想改变图像大小，只需要添加第二个参数。在这个例子中是 512 x 512px。

```
$identicon->getImageDataUri('foo', 512);
```

### 3. 图片颜色

[](#3-图片颜色)

图像颜色是由字符串的哈希值自动生成的，但是你可以添加第三个参数指定一个颜色。

```
// 颜色值可以使用一个 6 字符的十六进制字符串
$identicon->getImageDataUri('bar', 64, 'A87EDF');

$identicon->getImageDataUri('bar', 64, '#A87EDF');

// 也可以使用由红(R)、绿(G)、蓝(B)数值组成的数组
$identicon->getImageDataUri('foo', 64, array(200, 100, 150));
```

### 4. 背景色

[](#4-背景色)

图像默认的背景色是透明的，你可以通过添加第四个参数指定背景色，和前面的前景色一样。

```
$identicon->getImageDataUri('bar', 64, null, 'A87EDF');
```

### 5. 边距

[](#5-边距)

默认是没有边距的，如果你想要带边距的图像，你可以添加第五个参数。推荐使用图像的大小的十分之一，实际图像的尺寸为`size + margin * 2`，即：图像的 size 为 100，边距为 10，则实际大小为 120\*120。

在这个例子中，我们设置了灰色的背景，这样你可以很明显的看到边距：

[![Identicon example #6](doc/benjaminAtYzalisDotCom_with_margin.png)](doc/benjaminAtYzalisDotCom_with_margin.png) [![Identicon example #7](doc/Benjamin_with_margin.png)](doc/Benjamin_with_margin.png) [![Identicon example #8](doc/8.8.8.8_with_margin.png)](doc/8.8.8.8_with_margin.png) [![Identicon example #9](doc/8.8.4.4_with_margin.png)](doc/8.8.4.4_with_margin.png) [![Identicon example #10](doc/yzalis_with_margin.png)](doc/yzalis_with_margin.png)

```
$identicon->getImageDataUri('foo', 100, null, '#f0f0f0', 10);
```

单元测试
----

[](#单元测试)

为了运行单元测试，你需要一组依赖，它们可以通过 Composer 安装：

```
php composer.phar install

```

一旦安装，就可以使用下面的命令：

```
./vendor/bin/phpunit

```

应该一切都好了。

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/31514ea25147cae763bdca01e6edaac154c97fda59994c49cf161f4b77c19b40?d=identicon)[WuChienKun](/maintainers/WuChienKun)

---

Top Contributors

[![2015WUJI01](https://avatars.githubusercontent.com/u/24295778?v=4)](https://github.com/2015WUJI01 "2015WUJI01 (4 commits)")

### Embed Badge

![Health badge](/badges/wuchienkun-laravel-identicon/health.svg)

```
[![Health](https://phpackages.com/badges/wuchienkun-laravel-identicon/health.svg)](https://phpackages.com/packages/wuchienkun-laravel-identicon)
```

###  Alternatives

[qafeen/manager

Manage, install and search laravel base packages.

122.8k](/packages/qafeen-manager)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)