Download the PHP package ballen/gravel without Composer
On this page you can find all versions of the php package ballen/gravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ballen/gravel
More information about ballen/gravel
Files in ballen/gravel
Package gravel
Short Description Gravel is a PHP library which provides easy access to get and display Gravatars.
License MIT
Homepage https://github.com/allebb/gravel
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package gravel
Gravel
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.
Requirements
This library is developed and tested for PHP 7.3+
This library is unit tested against PHP 7.3, 7.4, 8.0, 8.1 and 8.2!
If you need to use an older version of PHP, you should instead install the 2.x version of this library (see below for details).
License
This client library is released under the MIT license, a copy of the license is provided in this package.
Installation
The recommended way of installing the latest version of Gravel is via. Composer; To install using Composer type the following command at the console:
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.
If you need to use an older version of PHP, version 2.x.x supports PHP 5.3, 5.4, 5.5, 5.6, 7.0, 7.1 and 7.2, you can install this version using Composer with this command instead:
Laravel Integration
Gravel has optional support for Laravel 4.x, 5.x, 6.x, 7.x and 8.x; it comes with a Service Provider which will register the Facade for easy integration.
On Laravel 7.x and 8.x this will be auto-discovered and no need to add it to the config/app.php $providers array!
If you are using an earlier version of Laravel you will need to manually enable this, which can be achieved by opening your Laravel application's 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:
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:
Tests and coverage
This library is fully unit tested using PHPUnit.
I use GitHub Actions for continuous integration, which triggers tests for PHP 7.3, 7.4, 8.0, 8.1 and 8.2 every time a commit is pushed.
If you wish to run the tests yourself you should run the following:
Code coverage can also be ran and a report generated (this does require XDebug to be installed)...
Support
I am happy to provide support via. my personal email address, so if you need a hand drop me an email at: [[email protected]]().
