How to implement Facebook login in Laravel

A step-by-step guide on how to integrate Facebook login into a Laravel application using the Socialite library. The article covers Facebook OAuth configuration and how to handle the login process in Laravel.

In this article, we will learn how to implement Facebook login functionality in Laravel using the Socialite package. Socialite is a powerful library that supports integrating social logins such as Facebook, Google, and Twitter into Laravel applications.

Laravel Code:

Step 1: Install Laravel Socialite

To get started, install the Socialite package using Composer:

composer require laravel/socialite

Step 2: Configure Facebook OAuth

Go to Facebook Developers and create a new app to get the App ID and App Secret.

After you have the credentials, add them to the .env file in your Laravel project:

FACEBOOK_CLIENT_ID=your-facebook-app-id
FACEBOOK_CLIENT_SECRET=your-facebook-app-secret
FACEBOOK_REDIRECT_URL=https://yourdomain.com/auth/facebook/callback

Step 3: Configure Laravel

Add the following configuration to config/services.php:

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

Step 4: Create routes

Add routes to handle Facebook redirection and callback:

use Laravel\Socialite\Facades\Socialite;

Route::get('/auth/facebook', function () {
    return Socialite::driver('facebook')->redirect();
});

Route::get('/auth/facebook/callback', function () {
    $user = Socialite::driver('facebook')->user();

    // Handle login or registration
    $authUser = User::updateOrCreate([
        'facebook_id' => $user->getId(),
    ], [
        'name' => $user->getName(),
        'email' => $user->getEmail(),
    ]);

    Auth::login($authUser);

    return redirect()->intended('dashboard');
});

Step 5: Update the User model

Open User.php and add a facebook_id column to the users table by creating a migration:

php artisan make:migration add_facebook_id_to_users_table --table=users

Update the migration file:

Schema::table('users', function (Blueprint $table) {
    $table->string('facebook_id')->nullable();
});

Run the migration to update the users table:

php artisan migrate

Detailed explanation:

1. composer require laravel/socialite: Install the Socialite package to use OAuth services.
2. env('FACEBOOK_CLIENT_ID'): Retrieves credentials from the .env file for Facebook OAuth configuration.
3. Socialite::driver('facebook')->redirect(): Redirects the user to Facebook login.
4. Socialite::driver('facebook')->user(): Retrieves the user's information after successful login.
5. User::updateOrCreate(...): Creates or updates a user account based on the Facebook ID.

System requirements:

• Laravel 8.x or 9.x
• PHP 7.4 or higher
• Composer

How to install the libraries:

• Use Composer to install Socialite:

composer require laravel/socialite

Tips:

• Ensure HTTPS is configured for your application when using Facebook OAuth.
• Handle cases where users might not provide necessary information like email during the login process.

---