oauth2-client's Introduction

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:

Facebook
Github
Google
Instagram
LinkedIn
Microsoft

Adding support for other providers is trivial.

The library requires PHP 5.3+ and is PSR-0 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']));

        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

    }
}

List of built-in identity providers

Provider	uid	nickname	name	first_name	last_name	email	location	description	imageUrl	urls
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