OAuth 2.0 Client Library

This library makes it stupidly simple to integrate your application with OAuth 2.0 identity providers. It has built in support for:

• Eventbrite
• Facebook
• Github
• Google
• Instagram
• LinkedIn
• Microsoft
• Vkontakte

Adding support for other providers is trivial.

The library requires PHP 5.3+ and is PSR-4 compatible.

Usage

$provider = new League\OAuth2\Client\Provider\<provider name>(array(
    'clientId'  =>  'XXXXXXXX',
    'clientSecret'  =>  'XXXXXXXX',
    'redirectUri'   =>  'http://your-registered-redirect-uri/'
));

if ( ! isset($_GET['code'])) {

	// If we don't have an authorization code then get one
    $provider->authorize();

} else {

    try {

    	// Try to get an access token (using the authorization code grant)
        $t = $provider->getAccessToken('authorization_code', array('code' => $_GET['code']));

        // NOTE: If you are using Eventbrite you will need to add the grant_type parameter (see below)
        // $t = $provider->getAccessToken('authorization_code', array('code' => $_GET['code'], 'grant_type' => 'authorization_code'));

        try {

        	// We got an access token, let's now get the user's details
            $userDetails = $provider->getUserDetails($t);

            foreach ($userDetails as $attribute => $value) {
                var_dump($attribute, $value) . PHP_EOL . PHP_EOL;
            }

        } catch (Exception $e) {

            // Failed to get user details

        }

    } catch (Exception $e) {

        // Failed to get access token
	// If you have a refesh token you can use it here:
        $grant = new \League\OAuth2\Client\Grant\RefreshToken();
        $t = $provider->getAccessToken($grant, array('refresh_token' => $refreshToken));
    }
}

List of built-in identity providers

Provider	uid	nickname	name	first_name	last_name	email	location	description	imageUrl	urls
Eventbrite	string	null	null	null	null	string	null	null	null	null
Facebook	string	string	string	string	string	string	string	string	string	array (Facebook)
Github	string	string	string	null	null	string	null	null	null	array (Github, [personal])
Google	string	string	string	string	string	string	null	null	string	null
Instagram	string	string	string	null	null	null	null	string	string	null
LinkedIn	string	null	string	null	null	string	string	string	string	string
Microsoft	string	null	string	string	string	string	null	null	string	string

Notes: Providers which return URLs sometimes include additional URLs if the user has provided them. These have been wrapped in []

License

The MIT License (MIT). Please see License File for more information.