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