PHPackages                             sh-sabbir/faker-php-avatar - 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. sh-sabbir/faker-php-avatar

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

sh-sabbir/faker-php-avatar
==========================

A provider for FakerPHP/Faker to generate Avatar Based on DiceBear

156201PHP

Since Feb 24Pushed 4y ago1 watchersCompare

[ Source](https://github.com/sh-sabbir/FakerPHP-Avatar)[ Packagist](https://packagist.org/packages/sh-sabbir/faker-php-avatar)[ RSS](/packages/sh-sabbir-faker-php-avatar/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

[![Social card of FakerPHP-Avatar](/assets/socialcard.png)](/assets/socialcard.png)

FakerPHP Avatar
===============

[](#fakerphp-avatar)

[![Packagist Downloads](https://camo.githubusercontent.com/2181d380a5bcbd93940010b96d875d5e66abae70a0fe5153a34cf0cd94aa2e68/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73682d7361626269722f66616b65722d7068702d6176617461723f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/sh-sabbir/faker-php-avatar) [![GitHub file size in bytes](https://camo.githubusercontent.com/92f0849e009b575a544571ae0d3fcda3d59f8ffb31c3e3f475caa4ad8f04156a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73697a652f73682d7361626269722f46616b65725048502d4176617461722f41766174617250726f76696465722e7068703f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/92f0849e009b575a544571ae0d3fcda3d59f8ffb31c3e3f475caa4ad8f04156a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73697a652f73682d7361626269722f46616b65725048502d4176617461722f41766174617250726f76696465722e7068703f7374796c653d666f722d7468652d6261646765) [![GitHub](https://camo.githubusercontent.com/537b1a62879b65b5a632819bbd384d751686005011347d1ec161346106fba3b4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f73682d7361626269722f46616b65725048502d4176617461723f7374796c653d666f722d7468652d6261646765)](https://github.com/sh-sabbir/FakerPHP-Avatar/blob/master/LICENSE)

FakerPHP Avatar is an addon package for [Faker](https://github.com/FakerPHP/Faker) to generate fake avatars based on [DiceBear](https://avatars.dicebear.com/). It Supports all **22 styles** of DiceBear.

Getting Started
---------------

[](#getting-started)

### Installation

[](#installation)

FakerPHP Avatar requires Faker >= 1.0.

```
composer require sh-sabbir/faker-php-avatar
```

### Documentation

[](#documentation)

Full documentation can be found over on [sh-sabbir.github.io/FakerPHP-Avatar](https://sh-sabbir.github.io/FakerPHP-Avatar).

### Basic Usage

[](#basic-usage)

#### Add Provider

[](#add-provider)

```
$faker = Faker\Factory::create();
$faker->addProvider(new Sabbir\Faker\AvatarProvider($faker));
```

#### Default settings

[](#default-settings)

```
$faker->avatarUrl($style = "adventurer", $size = null, $slug = null, $bg = null, $scale = null, $flip = null);
```

#### Generate Avatar URL

[](#generate-avatar-url)

```
$url = $faker->avatarUrl();
// https://avatars.dicebear.com/api/adventurer/:seed.svg

$url = $faker->avatarUrl('male');
// https://avatars.dicebear.com/api/male/:seed.svg

$url = $faker->avatarUrl('male',100);
// https://avatars.dicebear.com/api/adventurer/:seed.svg?size=100

$url = $faker->avatarUrl('male',100,'my-custom-slug');
// https://avatars.dicebear.com/api/adventurer/my-custom-slug.svg?size=100

$url = $faker->avatarUrl('male',100,'my-custom-slug','#cfcfcf');
// https://avatars.dicebear.com/api/adventurer/my-custom-slug.svg?b=%23cfcfcf&size=100

$url = $faker->avatarUrl('male',100,'my-custom-slug','#cfcfcf',100);
// https://avatars.dicebear.com/api/adventurer/my-custom-slug.svg?size=100&b=%23cfcfcf&scale=100

$url = $faker->avatarUrl('male',100,'my-custom-slug','#cfcfcf',100,1);
// https://avatars.dicebear.com/api/adventurer/my-custom-slug.svg?size=100&b=%23cfcfcf&scale=100&flip=1
```

Check [documentation](https://sh-sabbir.github.io/FakerPHP-Avatar) for more complex example.

### Available Styles

[](#available-styles)

Style NameOption ValueAdventureradventurer *(Default)*Adventurer Neutraladventurer-neutralAvataaarsavataaarsBig Earsbig-earsBig Ears Neutralbig-ears-neutralBig Smilebig-smileBotttsbotttsCroodlescroodlesCroodles Neutralcroodles-neutralGridygridyHumanhumanIdenticonidenticonInitialsinitialsJdenticonjdenticonMalemaleFemalefemaleMicahmicahMiniavsminiavsOpen Peepsopen-peepsPersonaspersonasPixel Artpixel-artPixel Art Neutralpixel-art-neutral### All Settings and Default Values

[](#all-settings-and-default-values)

ParameterTypeDefaultAvailable$style`String`adventurerCheck [here](#available-styles)$size`integer``null`integer without and extension. For example `150px` write `150`$slug`string``null`It will be the filename. If you define this you will get specific imgaes everytime. write it like this `my-avatar-image`. Don't include any file extension$bg`string` `hex colorcode``null`Background Color. Accepts all kind of valid Hex Color Code$scale`integer``null``0` to higest integer you can imagine but I suggest you not to imagine sky high 😉$flip`boolean``null`It accepts `0` or `1` where `0 is false` & `1 is true`License
-------

[](#license)

Faker is released under the MIT License. See [`LICENSE`](LICENSE) for details.

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity27

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/7eaba8f1c00871ec04a401db4131c5e09be158efa1d5239cb88aac30695161dc?d=identicon)[sh-sabbir](/maintainers/sh-sabbir)

---

Top Contributors

[![sh-sabbir](https://avatars.githubusercontent.com/u/9151027?v=4)](https://github.com/sh-sabbir "sh-sabbir (7 commits)")

---

Tags

avataravatar-generatorfakerfaker-generator

### Embed Badge

![Health badge](/badges/sh-sabbir-faker-php-avatar/health.svg)

```
[![Health](https://phpackages.com/badges/sh-sabbir-faker-php-avatar/health.svg)](https://phpackages.com/packages/sh-sabbir-faker-php-avatar)
```

PHPackages © 2026

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