PHPackages                             pyrrah/gravatar-bundle - 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. [API Development](/categories/api)
4. /
5. pyrrah/gravatar-bundle

ActiveSymfony-bundle[API Development](/categories/api)

pyrrah/gravatar-bundle
======================

The simple way to use Gravatar API for Symfony 7 and Symfony 8

v1.6.0(3w ago)11101.1k↓61.3%7MITPHPPHP >=8.4

Since Sep 29Pushed 3w ago1 watchersCompare

[ Source](https://github.com/Pyrrah/GravatarBundle)[ Packagist](https://packagist.org/packages/pyrrah/gravatar-bundle)[ Docs](https://github.com/Pyrrah/GravatarBundle)[ RSS](/packages/pyrrah-gravatar-bundle/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (6)Versions (14)Used By (0)

Pyrrah/GravatarBundle 🤳
=======================

[](#pyrrahgravatarbundle-)

[![Latest Version on Packagist](https://camo.githubusercontent.com/9c4e799305b842d1d29c4a2c330882dd5a7ec25a5dbc1e795445d9c224973b42/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7079727261682f67726176617461722d62756e646c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pyrrah/gravatar-bundle)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Total Contributors](https://camo.githubusercontent.com/c4bfa1f4b98ed0a003513d5bac5b4a5b7ff59b4814cdf881ea3f33f229203be8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f5079727261682f477261766174617242756e646c653f7374796c653d666c61742d737175617265)](../../graphs/contributors?all=1)[![Total Downloads](https://camo.githubusercontent.com/3602d042befdec2dd2d8e999d90f4852d59b4173d5266d6b89faa49e0fc0ca14/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7079727261682f67726176617461722d62756e646c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pyrrah/gravatar-bundle)

This bundle allows you to display your avatar anywhere on your site, via the Gravatar service.

Requirements
------------

[](#requirements)

- Symfony 7.4 and 8.x
- PHP 8.4 or higher
- A [Gravatar account](https://www.gravatar.com/site/signup) - it's free!

Installation
------------

[](#installation)

1. To install this bundle, run the following [Composer](https://getcomposer.org/) command :

```
composer require pyrrah/gravatar-bundle

```

2. If you always have some default for your gravatars such as size, rating, default image, or format, it can be configured in your config:

```
# config/packages/pyrrah_gravatar.yaml
pyrrah_gravatar:
  rating: "g"      # Allowed values: g, pg, r, x
  size: 80         # Image size in pixels
  default: "mp"   # Default image type (e.g. mp, identicon, monsterid, wavatar, retro, robohash, blank, 404)
  format: "base64" # Output format: url, base64
```

Note

The format option is specific to the bundle to choose the output format :

- url (default) : returns the https URL of the Gravatar image
- base64 : returns a base64-formatted image generated from the Gravatar URL

Tip: Use the "base64" option to hide your email hash used in the Gravatar URL.

Usage
-----

[](#usage)

All you have to do is use the helper like this example:

```

```

Or if you want to check if a gravatar email exists:

```
{% if gravatar_exists('alias@domain.tld') %}
  The email is an gravatar email
{% endif %}
```

Or with parameters (including default):

```

```

Where:

- `size` (int) : Image size in pixels
- `rating` (string) : Allowed values: g, pg, r, x
- `default` (string) : Default image type (e.g. mp, identicon, monsterid, wavatar, retro, robohash, blank, 404)
- `format` (string) : Output format: url, base64

For more information [look at the gravatar implementation pages](https://docs.gravatar.com/gravatar-images/php/).

Credits
-------

[](#credits)

- [Pierre-Yves Dick](https://github.com/Pyrrah)
- [All Contributors](../../graphs/contributors?all=1)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance95

Actively maintained with recent releases

Popularity41

Moderate usage in the ecosystem

Community16

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 90.7% 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.

###  Release Activity

Cadence

Every ~176 days

Recently: every ~135 days

Total

13

Last Release

24d ago

PHP version history (5 changes)v1.0.0PHP >=5.3.0

v1.1.0PHP >=7.1.3

v1.2.0PHP >=7.0.8

v1.5.0PHP >=8.1

v1.6.0PHP >=8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/854407?v=4)[Pierre-Yves](/maintainers/pyrrah)[@Pyrrah](https://github.com/Pyrrah)

---

Top Contributors

[![Pyrrah](https://avatars.githubusercontent.com/u/854407?v=4)](https://github.com/Pyrrah "Pyrrah (127 commits)")[![ping-localhost](https://avatars.githubusercontent.com/u/37925797?v=4)](https://github.com/ping-localhost "ping-localhost (9 commits)")[![Bukashk0zzz](https://avatars.githubusercontent.com/u/1908342?v=4)](https://github.com/Bukashk0zzz "Bukashk0zzz (2 commits)")[![druid628](https://avatars.githubusercontent.com/u/522820?v=4)](https://github.com/druid628 "druid628 (1 commits)")[![EmilePerron](https://avatars.githubusercontent.com/u/9383532?v=4)](https://github.com/EmilePerron "EmilePerron (1 commits)")

---

Tags

phpsymfony-bundlesymfony6symfony7symfony8gravatarpyrrahpicture gravatargravatar symfony7gravatar symfony8

### Embed Badge

![Health badge](/badges/pyrrah-gravatar-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/pyrrah-gravatar-bundle/health.svg)](https://phpackages.com/packages/pyrrah-gravatar-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.3M430](/packages/easycorp-easyadmin-bundle)[pimcore/pimcore

Content & Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.9M535](/packages/pimcore-pimcore)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k6.0M777](/packages/sylius-sylius)[chameleon-system/chameleon-base

The Chameleon System core.

1029.4k6](/packages/chameleon-system-chameleon-base)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1617.3k16](/packages/2lenet-crudit-bundle)[ecotone/symfony-bundle

Ecotone for Symfony — CQRS, Event Sourcing, Sagas, Durable Workflows, and Outbox on top of Symfony Messenger, via PHP attributes.

11258.2k1](/packages/ecotone-symfony-bundle)

PHPackages © 2026

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