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:
- Github
- 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 | location | description | imageUrl | urls | |
---|---|---|---|---|---|---|---|---|---|---|
string | string | string | string | string | string | string | string | string | array (Facebook) | |
Github | string | string | string | null | null | string | null | null | null | array (Github, [personal]) |
string | string | string | string | string | string | null | null | string | null | |
string | string | string | null | null | null | null | string | string | null | |
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 []