Socialite 社会化登录
Socialite 社会化登录
Laravel 社会化登录
简介
除了典型的基于表单的身份验证之外，Laravel 还提供了一种使用Laravel Socialite对 OAuth providers 进行身份验证的简单方便的方法。 Socialite 目前支持 Facebook，Twitter，LinkedIn，Google，GitHub，GitLab 和 Bitbucket 的身份验证。
其他平台的驱动器可以在Socialite Providers社区驱动网站查找。
升级 社会化登录
升级到 Socialite 的新主要版本时，请务必仔细查看升级指南.
安装
在开始使用社会化登录功能之前，通过 Composer 将 laravel/socialite 包添加到你的项目依赖里面：
composer require laravel/socialite
配置
在使用 Socialite 之前，您还需要为应用程序使用的 OAuth 服务添加凭据。 这些凭证应该放在你的config / services.php配置文件中，并且应该使用密钥facebook，twitter，linkedin，google，github，gitlab或bitbucket， 取决于您的应用程序所需的提供商。 例如：
'github' => [ 'client_id' => env('GITHUB_CLIENT_ID'), 'client_secret' => env('GITHUB_CLIENT_SECRET'), 'redirect' => 'http://your-callback-url', ],
如果
redirect项的值是个相对路径，它会自动解析为全称 URL 。
路由
接下来，就要对用户认证了！这需要两个路由：一个路由用于把用户重定向到 OAuth 提供器，另一个则用于在认证完成后接收相应提供器的回调请求。可以通过 facade 方式Socialite::来访问 Socialite：
redirect(); } /** * Obtain the user information from GitHub. * * @return \Illuminate\Http\Response */ public function handleProviderCallback() { $user = Socialite::driver('github')->user(); // $user->token; } }
redirect方法负责将用户发送到 OAuth 提供程序，而user方法将读取传入请求并从提供程序检索用户的信息。
当然，还需要在你的控制器方法中定义好路由规则：
Route::get('login/github', 'Auth\LoginController@redirectToProvider'); Route::get('login/github/callback', 'Auth\LoginController@handleProviderCallback');
可选参数
许多 OAuth 提供程序支持重定向请求中的可选参数。 要在请求中包含任何可选参数，请使用关联数组调用with方法：
return Socialite::driver('google') ->with(['hd' => 'example.com']) ->redirect();
使用
with方法时，注意不要传递任何保留的关键字，如state或response_type。
访问作用域
在重定向用户之前，您还可以使用scopes方法在请求中添加其他「作用域」。 此方法将所有现有范围与您提供的范围合并：
return Socialite::driver('github') ->scopes(['read:user', 'public_repo']) ->redirect();
您可以使用setScopes方法覆盖所有现有范围：
return Socialite::driver('github') ->setScopes(['read:user', 'public_repo']) ->redirect();
无认证状态
stateless方法可用于禁用会话状态验证。 在向 API 添加社交身份验证时，这非常有用：
return Socialite::driver('google')->stateless()->user();
获取用户实例
有了用户实例之后，就可以获取更多用户详情：
$user = Socialite::driver('github')->user(); // OAuth2 Providers $token = $user->token; $refreshToken = $user->refreshToken; // not always provided $expiresIn = $user->expiresIn; // OAuth1 Providers $token = $user->token; $tokenSecret = $user->tokenSecret; // 获取所有 Providers $user->getId(); $user->getNickname(); $user->getName(); $user->getEmail(); $user->getAvatar();
从令牌中检索用户详细信息 (OAuth2)
如果你已经有了一个用户的有效访问令牌，你可以使用userFromToken方法检索用户的详细信息。
$user = Socialite::driver('github')->userFromToken($token);
从令牌和秘钥中检索用户详细信息 (OAuth1)
如果你已经有了一个有效的用户令牌 / 秘钥，你可以使用userFromTokenAndSecret方法检索他们的详细信息：
$user = Socialite::driver('twitter')->userFromTokenAndSecret($token, $secret);