包简介

A package to generate avatars with initials for PHP

README 文档

README

Ever seen those avatars (basically everywhere) that has your initials — mine would be LR; Lasse Rafn — well this package allows you to generate those, in a simple manner.

Backers

Thank you to all our backers! 🙏 [Become a backer]

Installation

You just require using composer and you're good to go!

composer require lasserafn/php-initial-avatar-generator

Rad, and long, package name.. huh? Sorry. I'm not very good with names.

Usage

As with installation, usage is quite simple. Generating a image is done by running:

$avatar = new LasseRafn\InitialAvatarGenerator\InitialAvatar();

$image = $avatar->name('Lasse Rafn')->generate();

Thats it! The method will return a instance of Image from Intervention so you can stream, download or even encode the image:

return $image->stream('png', 100);

You can also just pass along the initials, and it will use those. Should you just include a first name, it will use the first two letters of it.

Example usage in a webpage

To display the image generated by the InitialAvatarGenerator library directly on a webpage, you can utilize PHP headers to output the image as a stream or generate a temporary file and display it using an <img> tag.

To output the image as a stream, you can create a separate PHP endpoint (like avatar.php) that generates the avatar image and streams it as a PNG. Then, you use the URL of this endpoint as the src of an <img> tag on your webpage.

An example endpoint file (avatar.php) is below:

<?php
require 'vendor/autoload.php'; 

use LasseRafn\InitialAvatarGenerator\InitialAvatar;

header('Content-Type: image/png'); // Set the content type to PNG

$avatar = new InitialAvatar();
$name = isset($_GET['name']) ? $_GET['name'] : 'Default User';

// Generate the image
$image = $avatar->name($name)->generate();

// Stream the image directly to the output
echo $image->stream('png', 100);
exit;

In the HTML file, you can reference the snippet below:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Avatar Example</title>
</head>
<body>
    <h1>User Avatar</h1>
    <!-- Use the PHP endpoint as the image source -->
    <img src="avatar.php?name=John Doe" alt="Avatar for John Doe" width="100" height="100">

    <img src="avatar.php?name=Jane Smith" alt="Avatar for Jane Smith" width="100" height="100">
</body>
</html>

SVG generation

$avatar = new LasseRafn\InitialAvatarGenerator\InitialAvatar();

echo $avatar->name('Lasse Rafn')->generateSvg()->toXMLString(); // returns SVG XML string

Supported methods and parameters

Of cause, passing a name is not the only thing this sweet thing does!

Name (initials) - default: JD

$image = $avatar->name('Albert Magnum')->generate();

AutoFont - default: false

Will detect language script (using lasserafn/php-string-script-language) and use a font that supports it.

$image = $avatar->autoFont()->generate();

Width - default: 48

// will be 96 pixels wide.
$image = $avatar->width(96)->generate();

Height - default: 48

// will be 96 pixels tall.
$image = $avatar->height(96)->generate();

Size - default: 48 (proxy for `$avatar->width(X)->height(X)`)

// will be 96x96 pixels.
$image = $avatar->size(96)->generate();

Background color - default: #f0e9e9

// will be red
$image = $avatar->background('#ff0000')->generate();

Font color - default: #8b5d5d

// will be red
$image = $avatar->color('#ff0000')->generate();

Auto Color

// Will choose a background color based on `name` and a contrasting font color. The color for a specific name will always be the same.
$image = $avatar->autoColor()->generate();

Font file - default: /fonts/OpenSans-Regular.ttf

Two fonts with two variants are included:

/fonts/OpenSans-Regular.ttf
/fonts/OpenSans-Semibold.ttf
/fonts/NotoSans-Bold.ttf
/fonts/NotoSans-Regular.ttf

The method will look for the font, if none found it will append __DIR__ and try again, and if not it will default to the first GD Internal Font. If you input an integer between 1 and 5, it will use a GD Internal font as per that number.

// will be Semibold
$image = $avatar->font('/fonts/OpenSans-Semibold.ttf')->generate();

Font name (for SVGs) - default: Open Sans, sans-serif

$image = $avatar->fontName('Arial, Helvetica, sans-serif')->generate();

Length - default: 2

$image = $avatar->name('John Doe Johnson')->length(3)->generate(); // 3 letters = JDJ

Switching driver - default: gd

$image = $avatar->gd()->generate(); // Uses GD driver
$image = $avatar->imagick()->generate(); // Uses Imagick driver

Rounded - default: false

$image = $avatar->rounded()->generate();

Smooth - default: false

Makes rounding smoother with a resizing hack. Could be slower.

$image = $avatar->rounded()->smooth()->generate();

If you are going to use rounded(), you want to use smooth() to avoid pixelated edges. Disabled by default because it COULD be slower. I would recommend just rounding with CSS.

Font Size - default: 0.5

$image = $avatar->fontSize(0.25)->generate(); // Font will be 25% of image size.

If the Image size is 50px and fontSize is 0.5, the font size will be 25px.

Chaining it all together

We will not use the ->font() method in this example; as I like the regular one.

return $avatar->name('Lasse Rafn')
              ->length(2)
              ->fontSize(0.5)
              ->size(96) // 48 * 2
              ->background('#8BC34A')
              ->color('#fff')
              ->generate()
              ->stream('png', 100);

Now, using that in a image (sized 48x48 pixels for retina):

<img src="url-for-avatar-generation" width="48" height="48" style="border-radius: 100%" />

Will yield:

Rounded for appearance; the actual avatar is a filled square

Font Awesome Support

The package supports FontAwesome (v5) and already distributes the free version as otf format (see /fonts folder).

However, when using FontAwesome you may want to display one specific icon instead of the user's initials. This package, therefore, provides a handy glyph($code) method to be used along with FontAwesome.

First, you need to "find" the respective unicode for the glyph you want to insert. For example, you may want to display a typical "user" icon (unicode: f007). The unicode is located near the name of the icon (e.g., see here the user icon as an example here: https://fontawesome.com/icons/user ).

An example for rendering a red avatar with a white "user" glyph would look like this:

// note that we
// 1) use glyph() instead of name
// 2) change the font to FontAwesome!
return $avatar->glyph('f007')
              ->font('/fonts/FontAwesome5Free-Regular-400.otf')
              ->color('#fff')
              ->background('#ff0000')
              ->generate()
              ->stream('png', 100);

Requirements

PHP +7.0
Fileinfo Extension (from intervention/image)

Script/Language support

Some letters are not supported by the default font files, so I added some fonts to add support. You must use autoFont() to enable this feature. Supported are:

Arabic
Armenian
Bengali
Georgian
Hebrew
Mongolian
Chinese
Thai
Tibetan

Contributors

Open Source is best when supported by a community. Any size of contribution is very appreciated.

Supported Image Libraries (from intervention/image)

GD Library (>=2.0)
Imagick PHP extension (>=6.5.7)

lasserafn/php-initial-avatar-generator 适用场景与选型建议

lasserafn/php-initial-avatar-generator 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 4.45M 次下载、GitHub Stars 达 440，最近一次更新时间为 2017 年 01 月 14 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「image」「avatar」「svg」「Initials」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 lasserafn/php-initial-avatar-generator 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 lasserafn/php-initial-avatar-generator 我们能提供哪些服务？

定制开发 / 二次开发

基于 lasserafn/php-initial-avatar-generator 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 lasserafn/php-initial-avatar-generator 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

asbiin/laravel-adorable 4

Generate an Adorable Avatar for Laravel

slavkovrn/yii2-lightbox 1

Yii2 LightBox image galary widget uses Lightbox v2.10.0 by Lokesh Dhakar

husseinalhammad/fontawesome-svg 18

PHP class to add Font Awesome 5+'s SVG icons inline without Javascript.

vierwd/svg-inliner 1

Utility functions to inline SVGs in PHP Projects

slavkovrn/yii2-imagecarousel 5

The Yii2 extension uses jQuery jquery.carousel-1.1.min.js and makes image carousel from php array of structure defined.

voltra/filament-svg-avatar 5

Change the default avatar url provider with one for inline SVGs

lasserafn/php-initial-avatar-generator

包简介

关键字：

README 文档

README

Backers

Sponsors

Installation

Usage

Example usage in a webpage

SVG generation

Supported methods and parameters

Name (initials) - default: JD

AutoFont - default: false

Width - default: 48

Height - default: 48

Size - default: 48 (proxy for `$avatar->width(X)->height(X)`)

Background color - default: #f0e9e9

Font color - default: #8b5d5d

Auto Color

Font file - default: /fonts/OpenSans-Regular.ttf

Font name (for SVGs) - default: Open Sans, sans-serif

Length - default: 2

Switching driver - default: gd

Rounded - default: false

Smooth - default: false

Font Size - default: 0.5

Chaining it all together

Font Awesome Support

Requirements

Script/Language support

Contributors

Supported Image Libraries (from intervention/image)

lasserafn/php-initial-avatar-generator 适用场景与选型建议

与 lasserafn/php-initial-avatar-generator 相关的其它包

统计信息

GitHub 信息

其他信息

lasserafn/php-initial-avatar-generator

包简介

关键字：

README 文档

README

Backers

Sponsors

Installation

Usage

Example usage in a webpage

SVG generation

Supported methods and parameters

Name (initials) - default: JD

AutoFont - default: false

Width - default: 48

Height - default: 48

Size - default: 48 (proxy for $avatar->width(X)->height(X))

Background color - default: #f0e9e9

Font color - default: #8b5d5d

Auto Color

Font file - default: /fonts/OpenSans-Regular.ttf

Font name (for SVGs) - default: Open Sans, sans-serif

Length - default: 2

Switching driver - default: gd

Rounded - default: false

Smooth - default: false

Font Size - default: 0.5

Chaining it all together

Font Awesome Support

Requirements

Script/Language support

Contributors

Supported Image Libraries (from intervention/image)

lasserafn/php-initial-avatar-generator 适用场景与选型建议

与 lasserafn/php-initial-avatar-generator 相关的其它包

统计信息

GitHub 信息

其他信息

Size - default: 48 (proxy for `$avatar->width(X)->height(X)`)