Facebook Login With PHP Laravel Socialite

We will implement a Facebook login with the PHP Laravel Socialite package. This package is really awesome for all social logins.

We will cover the following

1. Laravel Installation
2. Socialite Package Downloading
3. Using Facebook Account To Get OAuth For Code
4. Database Users Table Setup
5. Setting Up OAuth Details For Laravel Socialite
6. Route Setup For Facebook Socialite
7. Controller Code For Calling Facebook Website
8. Controller Code For Callback From Facebook

I have also written an article on Google, Twitter, GitHub, Facebook & Many Other Social Generic Logins With PHP Laravel Socialite

---

Step 1 - Laravel Installation

If you have already setup Laravel then skip to the next step. Let's install Laravel application with the composer.

composer create-project --prefer-dist laravel/laravel socialite_testing

If you would like to learn more on the composer then I have written an article on it @ What Is Composer? How Does It Work? Useful Composer Commands And Usage

---

Step 2 - Socialite Package Downloading

For working with any social login we are having a cool official package from Laravel Socialite. Let's integrate it on our project using composer with the following command

composer require laravel/socialite

---

Step 3 - Using Facebook Account To Get OAuth For Code

First, go to the Facebook developer website using this link Facebook Developers. And Sign In to your account. Now you will be able to see the following screen

1) My Apps - After login to your Developer Facebook account click on My Apps option on the top right

2) Add New App - Now you will be able to see all your apps. Click on Add New App button to create the new app for the login feature

---

Add App Details

Now you will be able to see the following modal box in which you can add appropriate details and click on the Create App ID button.

---

Get OAuth Details

1) Under Settings click on the Basic link to check your Facebook OAuth details

2) This is your OAuth App Client ID

3) Is your OAuth App Client Secret.

---

Add Platform

Don't forget this step else the return redirect URL after successful authentication won't work

To add the platform you can navigate to Settings -> Basic -> Add Platform -> Website ->

http://localhost:8888

---

Step 4 - Database Setup For Users

Basically we need to store the Provider Type and Provider Auth Token in our database so that we can verify the user for later usage

Users Migration

Schema::create('users', function (Blueprint $table) {
    $table->bigIncrements('id');
    $table->string('provider_type')->nullable()->comment('Social Account Type');
    $table->string('provider_token')->nullable()->comment('Social Account Token');
    $table->string('name');
    $table->string('password')->nullable();
    $table->string('forgot_password')->nullable();
    $table->string('email');
    $table->string('phone')->nullable();
    $table->boolean('is_blocked')->default(0);
    $table->softDeletes();
    $table->timestamps();
});

I haven't used the default authentication for personal preferences, but feel free to use it. Please observe that I have nulled basically most of the fields.

---

Step 5 - Setting Up OAuth Details For Laravel Socialite

Let's configure the Facebook OAuth credentials in our Laravel application as follows

services.php (config/services.php)

'facebook' => [
    'client_id' => env('FACEBOOK_CLIENT_ID'),
    'client_secret' => env('FACEBOOK_CLIENT_SECRET'),
    'redirect' => env('FACEBOOK_CALLBACK_URL'),
]

Append to the end of the return [] array in services.php

Basically any socialite account needs 3 things in the configuration

i) OAuth Client ID

ii) OAuth Client Secret

iii) Redirect URL which will be used to redirect back to your website URL after successful authentication

As we must not store any credentials inside our code so we will put the credentials inside .env file

.env

# Facebook OAuth
FACEBOOK_CLIENT_ID=432902173384581
FACEBOOK_CLIENT_SECRET=a5d233f8fc8baa694ee10a3a34501e823
FACEBOOK_CALLBACK_URL=http://localhost:8888/auth/facebook/callback

---

Step 6 - Route Setup For Facebook Socialite

Now we have done all the configurations parts lets get to coding part.

First, lets create the routes for our application inside web.php file as follows

web.php

Route::get('/auth/facebook', 'AuthController@socialProvider');
Route::get('/auth/facebook/callback', 'AuthController@socialProviderCallback');

AuthController@socialProvider [/auth/facebook] - This route method will decide which social web application it needs to redirect

AuthController@socialProviderCallback [/auth/facebook/callback]- This route method will be the one which will be called back after the authentication is successful from Facebook and we will see how to register the user.

---

Step 7 - Controller Code For Calling Facebook Website

By using Laravel Socialite its breeze for developer's life as it will handle most of the part for us.

As we saw from routes that we are redirecting [AuthController@socialProvider] to AuthController's socialProvider method. The following is the implementation

AuthController -> socialProvider() [App / Http / Controllers / AuthController]

public function socialProvider()
{
  return Socialite::driver('facebook')->redirect();
}

Note: The driver's name must be the same as that of the services key name.

When you run the application on website with the following URL, it will take to the Facebook verification page

http://localhost:8888/auth/facebook

Now you will be redirected to Facebook login page if you have not logged in or Facebook authorize page in you have already logged in to it.

---

Step 8 - Controller Code For Callback From Facebook

With Step 7 when you click on Authorize button and if the authentication is successful then it will redirect back to [AuthController@socialProviderCallback] AuthControllers's socialProviderCallback method.

So now we need to implement how to handle once we get back the successful redirect. Let's implement it.

AuthController -> socialProviderCallback() [App / Http / Controllers / AuthController]

public function socialProviderCallback()
{
    /** Using try catch because if any user directly hits the URL then 
    * it will throw exception
    */
    try {
        /** Use socialite to get the user details like token, name, email, profile pic 
        * as per your needs 
        */
        $socialUser     = Socialite::driver('facebook')->user();
        $token          = $socialUser->token;
        $name           = $socialUser->name;
        $email          = $socialUser->email;

        /** Uncomment the following to check the details description of user details */
        //echo '<pre>'; print_r($socialUser);exit;
        
        /** Get the user details */
        $user           = User::where('email', $email)->first();

        /** If no user found with that email then you can insert into database */
        if (!$user) {
            /** Create new user with Facebook credentials */
            $newUser = User::create([
                'provider_type'     => 'facebook',
                'provider_token'    => $token,
                'name'              => $name,
                'email'             => $email,
            ]);
            /** User is valid and store his details in session and redirect to dashboard */
            session()->put('user_details', $newUser);
            return redirect('/user/dashboard')->send();
        }
        /** Check user with provider of your database */
        if ($user->provider_type != 'facebook') {
            session()->flash('error', 'Please try logging with Facebook');
            return redirect('/auth/login');
        }
        /** Every time after successful authentication we will update provider token of our database */
        $user->provider_token = $token;
        $user->save();
        
        /** User is valid and store his details in session and redirect to dashboard */
        session()->put('user_details', $user);
        return redirect('/user/dashboard')->send();
    } catch (\Exception $e) {
        session()->flash('error', 'Oops error in validating you. Try again');
        return redirect('/auth/login');
    }
}

I have tried to explain most of the code details with comments hope it helps you.

---

Conclusion

Hope you enjoyed the article. Please share it with your friends.

Articles For You

Firebase Cloud Messaging (FCM) Browser Web Push Notifications Using Javascript And PHP

SummerNote WYSIWYG Text Editor Save Images To Public Path In PHP Laravel

GitHub Login With PHP Laravel Socialite

Google, Twitter, GitHub, Facebook & Many Other Social Generic Logins With PHP Laravel Socialite

Create Gmail App Password For SMTP Mails

Laravel App Deployment Checks

Add Analytics To AMP (Accelerated Mobile Pages) HTML Pages

Install Apache Web Server On Ubuntu 20.04 / Linux & Manage It

Laravel Custom Maintenance Page

Securely SSH Your Server & Push Files With FileZilla

Accessors & Mutators In Laravel. Problem In Set Attribute While Saving/Updating Data & How To Resolve It

Generate Fake Data In PHP With Faker

Test Your Local Developing Laravel Web Application From Phone Browser Without Any Software

Run Raw Queries Securely In Laravel

Install Linux, NGINX, MYSQL, PHP (LEMP Stack) on Ubuntu