PHPackages                             flavioheleno/bigheads-php - 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 &amp; Helpers](/categories/utility)
4. /
5. flavioheleno/bigheads-php

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

flavioheleno/bigheads-php
=========================

Easily create characters for your projects (PHP Library for bigheads.io)

1151PHPCI failing

Since Feb 9Pushed 5y ago1 watchersCompare

[ Source](https://github.com/flavioheleno/bigheads-php)[ Packagist](https://packagist.org/packages/flavioheleno/bigheads-php)[ RSS](/packages/flavioheleno-bigheads-php/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependenciesVersions (1)Used By (0)

bigheads-php [![Build Status](https://camo.githubusercontent.com/81e360de15703a7bdffef67fff2e3bc04739286bb2929044c8c3079dd3b65f60/68747470733a2f2f7472617669732d63692e636f6d2f666c6176696f68656c656e6f2f62696768656164732d7068702e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/flavioheleno/bigheads-php) [![Maintainability](https://camo.githubusercontent.com/2f7af14c8862429bbbc9a1034b777f77e7912a3d632cab01100ffd455ba98523/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f31346239396638633535383536306639396162622f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/flavioheleno/bigheads-php/maintainability) [![Total Downloads](https://camo.githubusercontent.com/db925dcc0b7e7d55ebd7d777de91ce4bdeefac17a7c5011a16363d557567c645/68747470733a2f2f706f7365722e707567782e6f72672f666c6176696f68656c656e6f2f62696768656164732d7068702f646f776e6c6f616473)](//packagist.org/packages/flavioheleno/bigheads-php)
===================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#bigheads-php---)

Easily generate avatars for your projects with [Big Heads](https://bigheads.io).

This is a PHP Library that helps you build Big Heads (original project: [RobertBroersma/bigheads](https://github.com/RobertBroersma/bigheads)).

Install with composer
---------------------

[](#install-with-composer)

```
composer require flavioheleno/bigheads-php
```

Creating a random Big Head
--------------------------

[](#creating-a-random-big-head)

The Factory class can be used to generate a Big Head with randomized properties.

```
$bigHead = BigHeads\Factory::create();
```

Getting the Big Head URL
------------------------

[](#getting-the-big-head-url)

Retrieve the URL to use on an `` tag, for example.

```
$bigHead->getUrl();
```

Storing/Recoving
----------------

[](#storingrecoving)

Whenever the original class is required, it can be serialized and stored in plain text.

```
$serialized = serialize($bigHead);

$bigHead2 = unserialize($serialized);
```

Property Reference
------------------

[](#property-reference)

NameTypeDefault[Accessory](src/Properties/Accessory.php)Enum`null`[Body](src/Properties/Body.php)Enum`null`[CircleColor](src/Properties/CircleColor.php)Enum`null`[Clothing](src/Properties/Clothing.php)Enum`null`[ClothingColor](src/Properties/ClothingColor.php)Enum`null`[Eyebrows](src/Properties/Eyebrows.php)Enum`null`[Eyes](src/Properties/Eyes.php)Enum`null`FaceMaskBoolean`false`[FaceMaskColor](src/Properties/FaceMaskColor.php)Enum`null`[FacialHair](src/Properties/FacialHair.php)Enum`null`[Graphic](src/Properties/Graphic.php)Enum`null`[Hair](src/Properties/Hair.php)Enum`null`[HairColor](src/Properties/HairColor.php)Enum`null`[Hat](src/Properties/Hat.php)Enum`null`[HatColor](src/Properties/HatColor.php)Enum`null`LashesBoolean`false`[LipColor](src/Properties/LipColor.php)Enum`null`MaskBoolean`false`[Mouth](src/Properties/Mouth.php)Enum`null`SizeInteger`100`[SkinTone](src/Properties/SkinTone.php)Enum`null`Contributing
------------

[](#contributing)

There are a few helper scripts that can be called by composer, such as:

- Static Code Analysis: `php composer.phar run check`
- Code Linting: `php composer.phar run lint`
- Tests: `php composer.phar run test`

**NOTE:** to run the *Code Linting*, you must download the ruleset from [here](https://github.com/flavioheleno/phpcs-ruleset/blob/master/ruleset.xml) first.

License
-------

[](#license)

This library is licensed under the [MIT License](LICENSE).

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity30

Early-stage or recently created project

 Bus Factor1

Top contributor holds 77.8% 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/42b9c9cbc06973a61587667fc811b853f4d71843f35ba2535f3900083e69ab3f?d=identicon)[flavioheleno](/maintainers/flavioheleno)

---

Top Contributors

[![flavioheleno](https://avatars.githubusercontent.com/u/471860?v=4)](https://github.com/flavioheleno "flavioheleno (7 commits)")[![BrissouLaChankla](https://avatars.githubusercontent.com/u/28387293?v=4)](https://github.com/BrissouLaChankla "BrissouLaChankla (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

### Embed Badge

![Health badge](/badges/flavioheleno-bigheads-php/health.svg)

```
[![Health](https://phpackages.com/badges/flavioheleno-bigheads-php/health.svg)](https://phpackages.com/packages/flavioheleno-bigheads-php)
```

###  Alternatives

[fideloper/proxy

Set trusted proxies for Laravel

7.3k174.4M550](/packages/fideloper-proxy)[fakerphp/faker

Faker is a PHP library that generates fake data for you.

3.9k358.5M3.4k](/packages/fakerphp-faker)[consolidation/robo

Modern task runner

2.7k62.9M408](/packages/consolidation-robo)[brick/money

Money and currency library

1.9k37.9M102](/packages/brick-money)[jetbrains/phpstorm-stubs

PHP runtime &amp; extensions header files for PhpStorm

1.4k27.7M67](/packages/jetbrains-phpstorm-stubs)[illuminate/support

The Illuminate Support package.

583107.1M34.3k](/packages/illuminate-support)

PHPackages © 2026

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