Social OAuth authentication for Laravel 5 which provides oAuth support in PHP 5.3+ and is very easy to integrate with any project which requires an oAuth client. This package use Laravel Socialite. For Laravel 4 look this package
The library supports OAuth 2.0 compliant services. A list of currently implemented services can be found below. More services will be implemented soon.
Included service implementations:
- OAuth2
- GitHub
- Bitbucket
- Dribbble
- Youtube
- Gitlab
- more to come!
Laravel Support version
| Laravel | laravel-oauth |
|---|---|
| <=5.5 | ^1.0 |
| 6.0 | ^1.1 |
- Include the package in your project using Composer
$ composer require mckenziearts/laravel-oauth-
Add the service provider to your
config/app.phpproviders array:For Laravel 5.5.+ - you're done.
Mckenziearts\LaravelOAuth\LaravelOAuthServiceProvider::class,- Publish the Vendor Assets files by running:
php artisan vendor:publish --provider="Mckenziearts\LaravelOAuth\LaravelOAuthServiceProvider"- Now that we have published a few new files to our application we need to reload them with the following command:
composer dump-autoloadWhen you published the vendor assets you added a new file inside of your config folder which is called config/laravel-oauth.php. This file contains a bunch of configuration you can use to configure your connexion using social networks.
First, you have to add your service like is defined on The official documentation of Socialite available here. Just setup your Oauth services for your application. Laravel/socialite is automatically installed by this package.
- Fisrt of all in the
config/laravel-oauth.phpfile you must define the default users table name to simplify migrations. By default users table is used
'users' => [
'table' => 'users',
],- Secondly you must specify the providers to use for social login in the
providersarray. To active a provider set the value totrue
'providers' => [
'facebook' => true,
'google' => true,
'github' => true,
],The last configuration is to stylize the button by editing class name and add or remove icon
Next, if you may want to re-publish the laravel-oauth assets, config, and the migrations run the following command:
php artisan vendor:publish --tag=laravel-oauth.assets --force
php artisan vendor:publish --tag=laravel-oauth.config --force
php artisan vendor:publish --tag=laravel-oauth.migrations --force
- Next to make sure you have the latest database schema run:
php artisan migrate
- Inside of your master.blade.php file include a header yield. Inside the head of your master or app.blade.php add the following:
@yield('css')
- Add the blade directive to your view where you want to display the socials buttons. The directive takes a parameter
loginto display the login text orresgisterfor the text related to the registration
@socialite('login')
- Add the style of the buttons by adding this to your view in the section in the
@yield('css')who defined in your master layout
@section('css')
<link href="{{ url('/vendor/mckenziearts/laravel-oauth/assets/css/socialite.css') }}" rel="stylesheet">
@endsection
- In the
Auth\LoginControllerof your application, add theOAuthSocialitetrait:
namespace App\Http\Controllers\Auth;
use App\Http\Controllers\Controller;
use Illuminate\Foundation\Auth\AuthenticatesUsers;
use Mckenziearts\LaravelOAuth\Traits\OAuthSocialite;
class LoginController extends Controller
{
use OAuthSocialite;
..With this feature you can overwrite the present methods on the trait if you want to customize them even more
- Add this routes to your default web route file
Route::get('/auth/{provider}', 'Auth\LoginController@redirectToProvider');
Route::get('/callback/{provider}', 'Auth\LoginController@handleProviderCallback');Please see the changelog.md for more information on what has changed recently.
$ composer testPlease see contributing.md for details and a todolist.
If you discover any security related issues, please email monneylobe@gmail.com instead of using the issue tracker.
MIT. Please see the license.md for more information.