danjdewhurst / Laravel-Passport-Facebook-Login by danjdewhurst
forked from mirkco/Laravel-Passport-Facebook-Login

Facebook Token Request Grant for Laravel Passport
21,120
28
7
Package Data
Maintainer Username: danjdewhurst
Maintainer Contact: jacob@mirk.co (Jacob Morris)
Package Create Date: 2017-07-06
Package Last Update: 2019-12-11
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-04-19 15:04:03
Package Statistics
Total Downloads: 21,120
Monthly Downloads: 215
Daily Downloads: 2
Total Stars: 28
Total Watchers: 7
Total Forks: 24
Total Open Issues: 2

Laravel Passport Facebook Login

Provides a new Laravel Passport Grant Client named facebook_login, allowing you to log a user in with just their Facebook Login token.

A new user will be created (and optionally assigned to an role - $user->attachRole(ID)) if the email address doesn't exist.

Installation:

Install with composer composer require danjdewhurst/laravel-passport-facebook-login. Use major version 1 for Passport 4 and below Laravel 5.6 compatibility.

Versions:

  • Laravel 5.7, with Passport 5, 6 or 7.

Dependencies:

Setup:

  • Add Danjdewhurst\PassportFacebookLogin\FacebookLoginGrantProvider::class to your list of providers after Laravel\Passport\PassportServiceProvider.
  • Add Danjdewhurst\PassportFacebookLogin\FacebookLoginTrait Trait to your User model (or whatever model you have configured to work with Passport).
  • Run php artisan vendor:publish, this will create a config/facebook.php file.
  • Enter your Facebook App details in your .env file: FACEBOOK_APP_ID and FACEBOOK_APP_SECRET.
  • Optional: To automatically attach a role (https://github.com/Zizaco/entrust) to new users, use the 'ATTACH_ROLE' env setting.

Config:

    /*
    |--------------------------------------------------------------------------
    | Application
    |--------------------------------------------------------------------------
    |
    | The facebook ID and secret from the developer's page
    |
    */

    'app' => [
        'id' => env('FACEBOOK_APP_ID'),
        'secret' => env('FACEBOOK_APP_SECRET'),
    ],

    /*
    |--------------------------------------------------------------------------
    | Registration Fields
    |--------------------------------------------------------------------------
    |
    | The name of the fields on the user model that need to be updated,
    | if null, they shall not be updated. (valid for name, first_name, last_name)
    |
    */

    'registration' => [
        'facebook_id' => env('FACEBOOK_ID_COLUMN', 'facebook_id'),
        'email'       => env('EMAIL_COLUMN', 'email'),
        'password'    => env('PASSWORD_COLUMN', 'password'),
        'first_name'  => env('FIRST_NAME_COLUMN', 'first_name'),
        'last_name'   => env('LAST_NAME_COLUMN', 'last_name'),
        'name'        => env('NAME_COLUMN', 'name'),
        'attach_role' => env('ATTACH_ROLE', null),
    ],

How To Use:

  • Make a POST request to https://your-site.com/oauth/token.
  • The POST body should contain
    1. grant_type = facebook_login
    2. fb_token = {token from facebook login}.
    3. client_id
    4. client_secret
  • An access_token and refresh_token will be returned if successful.

Assumptions:

  • Your User model has the folowing fields:
    • facebook_id
    • name or first_name & last_name
    • email
    • password

Why not use Laravel 5.5's auto-discovery?

We have found that using auto discovery can cause issues as this package relies on Laravel Passport been loaded before this package. Sometimes this doesn't happen, and caused issues as Laravel Passport sets up a singleton we reference.

We hope that one day there will be a fix to Laravel auto-discovery that will allow for dependencies to be handled better.

Credits:

  • https://github.com/mirkco/Laravel-Passport-Facebook-Login
  • https://github.com/mikemclin/passport-custom-request-grant