PHPackages                             bowphp/gravatar - 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. bowphp/gravatar

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

bowphp/gravatar
===============

A Bow Framework Gravatar package for retrieving gravatar image URLs or checking the existance of an image.

01PHP

Since Dec 10Pushed 1y ago1 watchersCompare

[ Source](https://github.com/bowphp/gravatar)[ Packagist](https://packagist.org/packages/bowphp/gravatar)[ RSS](/packages/bowphp-gravatar/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Gravatar for Bow Framework
==========================

[](#gravatar-for-bow-framework)

[![Total Downloads](https://camo.githubusercontent.com/eba0349eba3749de186aa66d72d32a3422795c816a961e6fbb7eb0e09e39a26d/68747470733a2f2f706f7365722e707567782e6f72672f626f777068702f67726176617461722f642f746f74616c2e737667)](https://packagist.org/packages/bowphp/gravatar)[![Latest Stable Version](https://camo.githubusercontent.com/cd6e74335437c6932adf672fd401d3547f63d7fff91242cacccc58e79223e452/68747470733a2f2f706f7365722e707567782e6f72672f626f777068702f67726176617461722f762f737461626c652e737667)](https://packagist.org/packages/bowphp/gravatar)[![License](https://camo.githubusercontent.com/1bae19cd7b42b96797e207612fa3f8fbbd91bb247690e00ab05b65799d6aa1c3/68747470733a2f2f706f7365722e707567782e6f72672f626f777068702f67726176617461722f6c6963656e73652e737667)](https://packagist.org/packages/bowphp/gravatar)

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

[](#installation)

First, pull in the package through Composer via the command line:

```
composer require bowphp/gravatar
```

Usage
-----

[](#usage)

Within your controllers or views, you can use

```
Gravatar::get('email@example.com');
```

This will return the URL to the gravatar image of the specified email address. In case of a non-existing gravatar, it will return return a URL to a placeholder image. You can set the type of the placeholder in the configuration option `fallback`. For more information, visit [gravatar.com](http://en.gravatar.com/site/implement/images/#default-image)

Alternatively, you can check for the existence of a gravatar image by using

```
Gravatar::exists('email@example.com');
```

This will return a boolean (`true` or `false`).

Or you can pass a url to a custom image using the fallback method:

```
Gravatar::fallback('http://urlto.example.com/avatar.jpg')->get('email@example.com');
```

Configuration
-------------

[](#configuration)

You can create different configuration groups to use within your application and pass the group name as a second parameter to the `get`-method:

There is a default group in `config/gravatar.php` which will be used when you do not specify a second parameter.

If you would like to add more groups, feel free to edit the `config/gravatar.php` file. For example:

```
return [
	'default' => [
		'size'   => 80,
		'fallback' => 'mm',
		'secure' => false,
		'maximumRating' => 'g',
		'forceDefault' => false,
		'forceExtension' => 'jpg',
 	],

 'small-secure' => [
    'size'   => 30,
    'secure' => true,
	],

	'medium' => [
    'size'   => 150,
	],
];
```

then you can use the following syntax:

```
Gravatar::get('email@example.com', 'small-secure'); // will use the small-secure group
Gravatar::get('email@example.com', 'medium'); // will use the medium group
Gravatar::get('email@example.com', 'default'); // will use the default group
Gravatar::get('email@example.com'); // will use the default group
```

Alternatively, you could also pass an array directly as the second parameter as inline options. So, instead of passing a configuration key, you pass an array, which will be merged with the default group:

```
Gravatar::get('email@example.com', ['size' => 200]);
```

###  Health Score

14

—

LowBetter than 2% of packages

Maintenance31

Infrequent updates — may be unmaintained

Popularity1

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity16

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/96099e66c63e31445f3f76a12e94104030f504eeb18f007216bb4ebdcdeadf7f?d=identicon)[papac](/maintainers/papac)

---

Top Contributors

[![papac](https://avatars.githubusercontent.com/u/9353811?v=4)](https://github.com/papac "papac (3 commits)")

### Embed Badge

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

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

PHPackages © 2026

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