1## [Hybridauth](https://hybridauth.github.io/) 3.3 2 3[![Build Status](https://travis-ci.org/hybridauth/hybridauth.svg?branch=master)](https://travis-ci.org/hybridauth/hybridauth) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/hybridauth/hybridauth/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/hybridauth/hybridauth/?branch=master) [![Latest Stable Version](https://poser.pugx.org/hybridauth/hybridauth/v/stable.png)](https://packagist.org/packages/hybridauth/hybridauth) [![Join the chat at https://gitter.im/hybridauth/hybridauth](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/hybridauth/hybridauth?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 4 5Hybridauth enables developers to easily build social applications and tools to engage websites visitors and customers on a social level that starts off with social sign-in and extends to social sharing, users profiles, friends lists, activities streams, status updates and more. 6 7The main goal of Hybridauth is to act as an abstract API between your application and the various social networks APIs and identities providers such as Facebook, Twitter and Google. 8 9#### Usage 10 11Hybridauth provides a number of basic [examples](https://github.com/hybridauth/hybridauth/tree/master/examples). You can also find complete Hybridauth documentation at https://hybridauth.github.io 12 13```php 14$config = [ 15 'callback' => 'https://example.com/path/to/script.php', 16 'keys' => [ 'key' => 'your-twitter-consumer-key', 'secret' => 'your-twitter-consumer-secret' ] 17]; 18 19try { 20 $twitter = new Hybridauth\Provider\Twitter($config); 21 22 $twitter->authenticate(); 23 24 $accessToken = $twitter->getAccessToken(); 25 $userProfile = $twitter->getUserProfile(); 26 $apiResponse = $twitter->apiRequest('statuses/home_timeline.json'); 27} 28catch (\Exception $e) { 29 echo 'Oops, we ran into an issue! ' . $e->getMessage(); 30} 31``` 32 33#### Requirements 34 35* PHP 5.4+ 36* PHP Session 37* PHP cURL 38 39#### Installation 40 41To install Hybridauth we recommend [Composer](https://getcomposer.org/), the now defacto dependency manager for PHP. Alternatively, you can download and use the latest release available at [Github](https://github.com/hybridauth/hybridauth/releases). 42 43#### Versions Status 44 45| Version | Status | Repository | Documentation | PHP Version | 46|---------|-------------|-------------------------|-------------------------|-------------| 47| 2.x | Maintenance | [v2][hybridauth-2-repo] | [v2][hybridauth-2-docs] | >= 5.3 | 48| 3.x | Development | [v3][hybridauth-3-repo] | [v3][hybridauth-3-docs] | >= 5.4 | 49 50[hybridauth-2-repo]: https://github.com/hybridauth/hybridauth/tree/v2 51[hybridauth-3-repo]: https://github.com/hybridauth/hybridauth/ 52[hybridauth-2-docs]: https://hybridauth.github.io/hybridauth/ 53[hybridauth-3-docs]: https://hybridauth.github.io/ 54 55#### Questions, Help and Support? 56 57For general questions (i.e, "how-to" questions), please consider using [StackOverflow](https://stackoverflow.com/questions/tagged/hybridauth) instead of the Github issues tracker. For convenience, we also have a [low-activity] [Gitter channel](https://gitter.im/hybridauth/hybridauth) if you want to get help directly from the community. 58 59#### License 60 61Hybridauth PHP Library is released under the terms of MIT License. 62 63For the full Copyright Notice and Disclaimer, see [COPYING.md](https://github.com/hybridauth/hybridauth/blob/master/COPYING.md). 64