datingvip/oauth2-client

OAuth 2.0 Client Library

v0.9 2020-07-01 15:32 UTC

Requires

• php: >=5.3.0
• guzzlehttp/guzzle: ~7

Requires (Dev)

• fzaninotto/faker: ~1
• phpunit/phpunit: ~9

Replaces

• league/oauth2-client: v0.9

MIT

• Alex Bilbie

• authorization
• Authentication
• oauth
• oauth2
• SSO
• identity
• idp
• single sign on

README

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

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