overtrue/laravel-socialite

Social OAuth authentication for Laravel 5.

2.0.0 2017-12-14 05:34 UTC

README

Installation

$ composer require "overtrue/laravel-socialite:~2.0"

if you have been installed the overtrue/socialite package, please remove it from composer.json before this command.

Configuration

  1. After installing the Socialite library, register the Overtrue\LaravelSocialite\ServiceProvider in your config/app.php configuration file:
'providers' => [
    // Other service providers...
    Overtrue\LaravelSocialite\ServiceProvider::class,
],
  1. Add the follow line to the aliases section of config/app.php:
'Socialite' => Overtrue\LaravelSocialite\Socialite::class,
  1. You will also need to add credentials for the OAuth services your application utilizes. These credentials should be placed in your config/socialite.php or config/services.php configuration file, and should use the key facebook, twitter, linkedin, google, github or bitbucket, depending on the providers your application requires. For example:
<?php

return [
    //...
    'github' => [
        'client_id'     => 'your-app-id',
        'client_secret' => 'your-app-secret',
        'redirect'      => 'http://localhost/socialite/callback.php',
    ],
    //...
];

Usage

<?php

namespace App\Http\Controllers;

use Socialite;
use Illuminate\Routing\Controller;

class AuthController extends Controller
{
    /**
     * Redirect the user to the GitHub authentication page.
     *
     * @return Response
     */
    public function redirectToProvider()
    {
        return Socialite::driver('github')->redirect();
    }

    /**
     * Obtain the user information from GitHub.
     *
     * @return Response
     */
    public function handleProviderCallback()
    {
        $user = Socialite::driver('github')->user();

        // $user->token;
    }
}

And register routes:

Route::get('/oauth/github', 'AuthController@redirectToProvider');
Route::get('/oauth/github/callback', 'AuthController@handleProviderCallback');

About more usage, please refer to overtrue/socialite.

PHP 扩展包开发

想知道如何从零开始构建 PHP 扩展包?

请关注我的实战课程,我会在此课程中分享一些扩展开发经验 —— 《PHP 扩展包实战教程 - 从入门到发布》

License

MIT