前言

第三方登录认证能简化用户登录/注册的操作，降低用户登录/注册的门槛，对提高应用的用户转化率很有帮助。

Socialite

Laravel 为我们提供了简单、易用的方式，使用 Laravel Socialite 进行 OAuth（OAuth1 和 OAuth2 都有支持） 认证。

SocialiteProviders

以 Weibo 为例

1.安装

composer require socialiteproviders/weibo

2.添加 Service Provider

'providers' => [  //    Laravel\Socialite\SocialiteServiceProvider::class,      SocialiteProviders\Manager\ServiceProvider::class, // add  ],

3.添加 Facades Aliase

'aliases' => [      'Socialite' => Laravel\Socialite\Facades\Socialite::class, // add  ],

4.添加事件处理器

文件app/Providers/EventServiceProvider.php

protected $listen = [      'SocialiteProviders\Manager\SocialiteWasCalled' => [          'SocialiteProviders\Weibo\WeiboExtendSocialite@handle',      ],  ];

这里顺便提一下 SocialiteProviders 的原理。

SocialiteProviders\Manager\ServiceProvider实际上是继承于Laravel\Socialite\SocialiteServiceProvider的，这是它的源码：

<?php    namespace SocialiteProviders\Manager;    use Illuminate\Contracts\Events\Dispatcher;  use Laravel\Socialite\SocialiteServiceProvider;    class ServiceProvider extends SocialiteServiceProvider  {      /**       * @param Dispatcher         $event       * @param SocialiteWasCalled $socialiteWasCalled       */      public function boot(Dispatcher $event, SocialiteWasCalled $socialiteWasCalled)      {          $event->fire($socialiteWasCalled);      }  }

它只是在启动时会触发SocialiteWasCalled事件，刚才在SocialiteProviders\Manager\SocialiteWasCalled事件的监听器中加上了事件处理器：SocialiteProviders\Weibo\WeiboExtendSocialite@handle。处理器的源码：

<?php    namespace SocialiteProviders\Weibo;    use SocialiteProviders\Manager\SocialiteWasCalled;    class WeiboExtendSocialite  {      public function handle(SocialiteWasCalled $socialiteWasCalled)      {          $socialiteWasCalled->extendSocialite('weibo', __NAMESPACE__.'\Provider');      }  }

处理器做的事情就是为 Socialite 添加了一个 weibo Driver，这样就可以使用 weibo 的 Driver 了。

5.添加路由

文件app/Http/routes.php

// 引导用户到新浪微博的登录授权页面  Route::get('auth/weibo', 'Auth\AuthController@weibo');  // 用户授权后新浪微博回调的页面  Route::get('auth/callback', 'Auth\AuthController@callback');

6.配置

文件config/services.php

'weibo' => [      'client_id' => env('WEIBO_KEY'),      'client_secret' => env('WEIBO_SECRET'),      'redirect' => env('WEIBO_REDIRECT_URI'),    ],

文件.env

WEIBO_KEY=yourkeyfortheservice  WEIBO_SECRET=yoursecretfortheservice  WEIBO_REDIRECT_URI=http://192.168.1.7/laravel/public/auth/callback

注意：192.168.1.7 是我本地虚拟机的地址，虚拟机可以连外网就可以测试了。貌似 QQ 的必须绑定域名才是测试。

7.代码实现

文件app/Http/Controllers/Auth/AuthController.php

 public function weibo() {   return \Socialite::with('weibo')->redirect();   // return \Socialite::with('weibo')->scopes(array('email'))->redirect();  }  public function callback() {   $oauthUser = \Socialite::with('weibo')->user();   var_dump($oauthUser->getId());   var_dump($oauthUser->getNickname());   var_dump($oauthUser->getName());   var_dump($oauthUser->getEmail());   var_dump($oauthUser->getAvatar());  }

访问http://192.168.1.7/laravel/public/auth/weibo，会跳转到新浪微博的登录授权页面，授权成功后，会跳转到http://192.168.1.7/laravel/public/auth/callback
返回的结果：

string(10) "3221174302"  string(11) "Mr_Jing1992"  NULL  NULL  string(50) "http://tp3.sinaimg.cn/3221174302/180/40064692810/1"

user 对象是现实了接口Laravel\Socialite\Contracts\User的，有以下几个方法：

<?php  namespace Laravel\Socialite\Contracts;  interface User  {   public function getId();   public function getNickname();   public function getName();   public function getEmail();   public function getAvatar();  }

但是，id 这个应该是所有第三方认证服务提供商都会返回的。不然那就没有办法作账号关联了。

获取到第三方的 id 后，如果这个 id 和你网站用户账号有绑定，就直接登录你网站用户的账号。如果没有任何账号与之绑定，就应该提示用户绑定已有账号或者是注册新账号什么的，这些具体逻辑就不在多说了。还有，在新浪上面还有一个 取消授权回调页 的值需要填，是用户在授权页点击“取消”按钮时新浪回调的页面。这个可以设置为你网站的登录页面或者其他页面。

最后：如有错误，还望指正。