为Laravel Socialite提供的Wave OAuth2认证提供者

5.0.0 2023-08-18 08:06 UTC

This package is auto-updated.

Last update: 2024-08-26 21:44:22 UTC


README

composer require socialiteproviders/wave

安装与基本使用

请参阅基本安装指南,然后按照以下特定提供者的说明操作。

在Wave中准备OAuth提供者和应用

在Wave开发者门户中创建一个新的应用以获取客户端ID和客户端密钥:(https://developer.waveapps.com/hc/en-us/articles/360019762711-Manage-Applications

将配置添加到config/services.php

'wave' => [
    'client_id' => env('WAVE_CLIENT_ID'),
    'client_secret' => env('WAVE_CLIENT_SECRET'),
    'redirect' => 'https://example.com/wave/callback',
],

添加提供者事件监听器

Laravel 11+

在Laravel 11中,默认的EventServiceProvider提供者已被移除。相反,在AppServiceProviderboot方法中使用Event外观的listen方法添加监听器。

  • 注意:除非您使用自己的提供者覆盖它们,否则您无需为内置的Socialite提供者添加任何内容。
Event::listen(function (\SocialiteProviders\Manager\SocialiteWasCalled $event) {
    $event->extendSocialite('wave', \SocialiteProviders\Wave\Provider::class);
});
Laravel 10或以下配置包的监听器以监听`SocialiteWasCalled`事件。

将事件添加到app/Providers/EventServiceProvider中的listen[]数组中。请参阅基本安装指南以获取详细说明。

protected $listen = [
    \SocialiteProviders\Manager\SocialiteWasCalled::class => [
        // ... other providers
        \SocialiteProviders\Wave\WaveExtendSocialite::class.'@handle',
    ],
];

使用方法

现在您应该能够像常规使用Socialite一样使用提供者(假设您已安装外观)

return Socialite::driver('wave')->redirect();

重定向到认证,然后

$user = Socialite::driver('wave')->user()

在返回函数中。用户将包含从OAuth源填充的idfirst_namelast_nameemail字段。