Comment utiliser OAuth2 avec php ?

OAuth2 est un protocole standard ouvert largement utilisé pour autoriser l'accès aux ressources des utilisateurs sans transmettre les noms d'utilisateur et les mots de passe directement à des applications tierces, telles que les réseaux sociaux tels que Google, Facebook et Twitter.

En PHP, vous pouvez utiliser des bibliothèques OAuth2 prêtes à l'emploi pour implémenter facilement le flux OAuth2, ou vous pouvez créer votre propre bibliothèque pour l'implémenter.

Dans cet article, nous nous concentrerons sur l'utilisation de la bibliothèque OAuth2 prête à l'emploi, sur la façon d'utiliser le protocole OAuth2 pour obtenir l'autorisation des utilisateurs et accéder à leurs ressources.

1. Installer la bibliothèque OAuth2

Tout d'abord, nous devons installer la bibliothèque OAuth2 disponible. Actuellement, il existe plusieurs bibliothèques OAuth2 différentes disponibles pour le développement PHP, notamment php-oauth2-client, thephpleague/oauth2-client et bshaffer/oauth2-server-php, entre autres. Dans cet article, nous utiliserons le client PHPleague/oauth2 comme bibliothèque OAuth2.

Pour installer cette bibliothèque, vous pouvez utiliser Composer, exécutez simplement la commande suivante dans le terminal :

composer require league/oauth2-client

2. Créer un objet client OAuth2

Une fois que nous avons installé la bibliothèque OAuth2, nous pouvons maintenant créer un objet client OAuth2. Ce client communiquera avec le fournisseur de services selon le protocole OAuth2 et maintiendra l'état de session entre nous et le fournisseur de services.

Dans cet exemple, nous utiliserons GitHub comme fournisseur OAuth2. Pour créer un objet client, utilisez le code suivant :

$clientId = 'your_client_id'; // Your GitHub Client ID
$clientSecret = 'your_client_secret'; // Your GitHub Client Secret
$redirectUri = 'http://example.com/oauth2callback'; // Your redirect URI

$provider = new LeagueOAuth2ClientProviderGithub([
    'clientId'          => $clientId,
    'clientSecret'      => $clientSecret,
    'redirectUri'       => $redirectUri,
]);

Le code ci-dessus créera un objet client OAuth2 nommé $provider, qui sera utilisé pour accéder au fournisseur OAuth2 sur GitHub. Parmi eux, nous devons fournir l'ID client, le secret client et l'URI de rappel qui nous sont attribués par GitHub.

3. Obtenir l'URL d'autorisation

Dans OAuth2, l'URL d'autorisation est utilisée pour guider l'utilisateur tout au long du processus d'autorisation OAuth2. Nous devons rediriger les utilisateurs vers l'URL d'autorisation afin qu'ils puissent autoriser notre application avant d'accéder aux ressources GitHub requises par notre application.

Pour obtenir l'URL d'autorisation, utilisez le code suivant :

$authorizationUrl = $provider->getAuthorizationUrl();

Le code ci-dessus renverra l'URL d'autorisation vers laquelle nous devons rediriger l'utilisateur.

header('Location: ' . $authorizationUrl);
exit;

4. Obtenir un jeton d'accès

Une fois que l'utilisateur a réussi à obtenir l'autorisation OAuth2 sur GitHub, il sera redirigé vers l'URL de rappel fournie par notre application. À ce stade, nous devons obtenir un jeton d'accès pour accéder ultérieurement aux ressources GitHub qui nécessitent une autorisation.

Ensuite, nous pouvons utiliser le code suivant pour obtenir le jeton d'accès :

$accessToken = $provider->getAccessToken('authorization_code', [
    'code' => $_GET['code']
]);

Le code ci-dessus utilisera le code d'autorisation pour demander le jeton d'accès et retournera l'objet $accessToken. Cet objet $accessToken contient le jeton d'accès et ses propriétés associées, telles que le délai d'expiration et le jeton d'actualisation, etc.

5. Accès aux ressources GitHub à l'aide de jetons d'accès

Maintenant que nous avons obtenu le jeton d'accès, nous pouvons l'utiliser pour accéder aux ressources GitHub qui nécessitent une autorisation, comme obtenir des informations sur les utilisateurs ou lire leur liste de référentiels.

Utilisez le code suivant pour obtenir des informations sur l'utilisateur :

$user = $provider->getResourceOwner($accessToken);
echo 'Hello, ' . $user->getName();

Le code ci-dessus utilisera le jeton d'accès pour appeler l'API du propriétaire de la ressource sur GitHub et renverra l'objet $user.

Veuillez noter que l'objet $user dans le code ci-dessus renverra le nom de l'utilisateur et d'autres propriétés associées, que nous pouvons utiliser pour obtenir des informations sur l'utilisateur et d'autres ressources GitHub.

6. Actualiser le jeton d'accès

Un jeton d'accès peut expirer ou devenir invalide, nous devons vérifier son statut au moment de l'exécution et actualiser à nouveau le jeton si nécessaire.

Utilisez le code suivant pour vérifier et actualiser le jeton d'accès :

if ($accessToken->hasExpired()) {
    $newAccessToken = $provider->getAccessToken('refresh_token', [
        'refresh_token' => $accessToken->getRefreshToken()
    ]);
}

// Use $newAccessToken to access protected resources

Le code ci-dessus vérifiera si le jeton d'accès a expiré et utilisera l'attribut rafraîchir_token pour demander un nouvel objet $accessToken qui contient le jeton d'accès actualisé et d'autres propriétés associées. .

À ce stade, nous avons appris à utiliser la bibliothèque PHPleague/oauth2-client pour implémenter le processus OAuth2. Nous pouvons désormais l'utiliser pour accéder à divers fournisseurs OAuth2 tels que Google, Facebook, Twitter et GitHub, entre autres.

Résumé

Dans cet article, nous avons appris comment utiliser la bibliothèque OAuth2 pour créer un client OAuth2 et utiliser le client pour obtenir une autorisation et accéder aux ressources protégées. Nous avons également appris à vérifier et actualiser les jetons d'accès pour garantir que nous avons toujours accès aux ressources dont nous avons besoin.

Veuillez noter que le protocole OAuth2 comporte des processus d'autorisation et des détails de mise en œuvre complexes, il faut donc faire preuve de prudence lors du développement de clients OAuth2. Cependant, en utilisant les bibliothèques OAuth2 disponibles dans le commerce, nous pouvons rendre ce processus relativement simple et direct.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!