A PHP Gravatar.com library enabling developers to easily access, display and manipulate user avatars in their applications.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
tests GravelTest test case complete and has 100% coverage of the main class. Jan 25, 2016
.gitignore Adds Scrutinizer and Travis support. Jan 25, 2016
LICENSE Updated version number to 1.2.0, HTTPS link retrieval is now set by d… Jan 17, 2016
README.md Adding CodeClimate badge to readme. Dec 4, 2016
composer.json Some composer.json updates (adding PHPUnit support in --dev mode) and… Jan 25, 2016
composer.lock Some composer.json updates (adding PHPUnit support in --dev mode) and… Jan 25, 2016
phpunit.xml Some composer.json updates (adding PHPUnit support in --dev mode) and… Jan 25, 2016



Build Status Code Coverage Scrutinizer Code Quality Code Climate Latest Stable Version Latest Unstable Version License

Gravel is a PHP library for working with Gravatar avatars.

Gravel is written and maintained by Bobby Allen, the library is licensed under the MIT license.


This library is developed and tested for PHP 5.3+

This library is unit tested against PHP 5.3, 5.4, 5.5, 5.6, HHVM and 7.0!


This client library is released under the MIT license, a copy of the license is provided in this package.


The recommended way of installing Gravel is via. Composer; To install using Composer type the following command at the console:

composer require ballen/gravel

Alternately you can add it to your composer.json file manually in the require section like so:

"ballen/gravel": "^2.0"

Then install the package by running the composer update ballen/gravel command.

You can also manually download the latest version as a zip or tar.gz archive of the library from GitHub and 'include' the Gravatar.php script (library) and use it standalone if you wish.

Laravel 4 and 5 Integration

Gravel has optional support for Laravel 4.x and 5.x and comes with a Service Provider which will register the Facade for easy integration.

Open your Laravel application configuration file config/app.php (or app/config/app.php if you are using Laravel 4.x)and add the following lines.

In the $providers array add the service providers for this package.


The Gravatar package will now be autoloaded by the Laravel framework (via. Composer) and use of the library is as simple...

Example usage

If you have installed the library using Composer or manually you can (as long as your application already requires or includes the composer autoload.php) then you can instantiate a new object instance and use it immediately in your application like so:

use Ballen\Gravel\Gravatar;

$avatar = new Gravatar('bobbyallen.uk@gmail.com');
$avatar->setSize(100); // We want a 100x100px sized avatar instead of the default 120x120px

* You can then obtain the avatar URL either by using the buildGravatarUrl() method or utilising
* the __toString() class method like so:
<image src="<?php echo $avatar; ?>">

There are a number of other "commented" examples on how you can utilise this library can be found in the examples/Examples.php file.

Laravel example

I decided to implement a Laravel type style (make(), get()) for the Laravel Facades therefore it should keep both the hardcore developers (setter and getter prefixed methods) as well as those developers that appreciate cleanly written method names!

If you have added the Laravel Service Provider and Aliases as documented above, you can utilise the library like so:

# Laravel 4.x example
return View::make('userprofile')
    ->with('gravatar', Gravatar::make('bobbyallen.uk@gmail.com')->size(200)->get());

# Laravel 5.x example (using the view() helper method)
return view('userprofile')
    ->with('gravatar', Gravatar::make('bobbyallen.uk@gmail.com')->size(200)->get());

Tests and coverage

This library is fully unit tested using PHPUnit.

I use TravisCI for continuous integration, which triggers tests for PHP 5.3, 5.4, 5.5, 5.6, 7.0 and HHVM every time a commit is pushed.

If you wish to run the tests yourself you should run the following:

# Install the Gravel Library with the 'development' packages this then includes PHPUnit!
composer install --dev

# Now we run the unit tests (from the root of the project) like so:

Code coverage can also be ran and a report generated (this does require XDebug to be installed)...

./vendor/bin/phpunit --coverage-html ./report


I am happy to provide support via. my personal email address, so if you need a hand drop me an email at: ballen@bobbyallen.me.