Laravel 5.1用户认证(三) —— 使用Socialite实现GitHub登录认证
1、引言
除了让用户走注册流程实现登录认证外,在社交网络日益发达的今天,许多网站还提供了使用社交网络账号实现第三方登录认证的功能。强大的Laravel也为这种功能提供了官方包——Socialite,Socialite目前支持国外多种社交媒体登录,包括Facebook、Twitter、Google、LinkedIn、GitHub以及Bitbucket。因为GFW的缘故,本节我们将简单演示如何通过Socialite使用GitHub进行第三方登录认证。
2、安装Socialite包
要使用Socialite,首先要在Laravel应用根目录执行如下命令加载依赖包:
composer require laravel/socialite
下载完成后接下来我们需要进行一系列的配置。
3、相关配置
首先在config/app.php
中将SocialiteServiceProvider
注册到providers
中:
Laravel\Socialite\SocialiteServiceProvider::class,
为方便使用将Socialite
门面添加到aliases
中:
'Socialite' => Laravel\Socialite\Facades\Socialite::class,
再然后我们在config/services.php
中添加github
相关配置信息:
'github' => [ 'client_id' => 'your github app client_id', 'client_secret' => 'your github app client_secret', 'redirect' => 'http://laravel.app:8000/auth/github/callback' ]
将client_id
和client_secret
修改成你自己的github应用对应的client_id和client_secret,如果没有的话需要去GitHub创建一个应用。具体创建方法如下:
创建GitHub应用
访问https://github.com/settings/developers页面,点击“Register new application”,填写表单信息并提交:
创建成功后显示如下:
点击应用名称(本例是LaravelApp)查看应用详情即可获取该应用的Client ID及Client Secret信息。
4、修改AuthController
配置好services.php
后接下来我们需要对AuthController
做如下修改:
<?php
namespace App\Http\Controllers;
use Socialite;
use App\User;
use Illuminate\Routing\Controller;
class AuthController extends Controller{
/**
* 将用户重定向到GitHub认证页面
*/
public function redirectToProvider()
{
return Socialite::driver('github')->redirect();
}
/**
* 从GitHub获取认证用户信息
*/
public function handleProviderCallback()
{
$user = Socialite::driver('github')->user();
dd($user);
}
}
5、注册认证路由
最后我们在routes.php
中为GitHub登录认证注册路由:
Route::get('auth/github', 'Auth\AuthController@redirectToProvider'); Route::get('auth/github/callback', 'Auth\AuthController@handleProviderCallback');
至此,我们已经完成了所有配置及修改,可以到浏览器进行测试了。
6、使用GitHub进行登录认证
在浏览器地址栏访问http://laravel.app:8000/auth/github
,页面会跳转到GitHub授权认证页面:
点击绿色的授权认证按钮,页面会跳转回调页面http://laravel.app:8000/auth/github/callback
,并输出用户信息,表明登录成功!
7、保存用户信息到本地数据库
Socialite默认不会保存用户信息到数据库,你可以通过选择保存GitHub用户信息或绑定GitHub账户和本地用户。这里我们配置保存GitHub用户信息到本地数据库。为此我们为users
表新增两个字段:github_id
和avatar
。同时修改AuthController
的handleProviderCallback
方法如下:
public function handleProviderCallback() { $user = Socialite::driver('github')->user(); if(!User::where('github_id',$user->id)->first()){ $userModel = new User; $userModel->github_id = $user->id; $userModel->email = $user->email; $userModel->name = $user->name; $userModel->avatar = $user->avatar; $userModel->save(); } $userInstance = User::where('github_id',$user->id)->firstOrFail(); Auth::login($userInstance); echo $user->name.'登录成功!'; }
这样用户在GitHub授权成功跳转到回调URL后用户信息就会保存到本地数据库。
扩展阅读:社交媒体登录认证提供者大全 —— Socialite Providers
24 Comments