laravel/socialite

Example Code

```php
<?php

namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use App\Models\User;
use Illuminate\Support\Facades\Auth;
use Laravel\Socialite\Facades\Socialite;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;

class SocialAuthController extends Controller
{
    /
     * Redirect the user to the provider authentication page.
     *
     * @param  string  $provider
     * @return \Symfony\Component\HttpFoundation\RedirectResponse
     */
    public function redirectToProvider(string $provider)
    {
        // Ensure the provider is configured in config/services.php
        // Example: 'github' => ['client_id' => env('GITHUB_CLIENT_ID'), 'client_secret' => env('GITHUB_CLIENT_SECRET'), 'redirect' => env('GITHUB_REDIRECT_URI')]
        return Socialite::driver($provider)->redirect();
    }

    /
     * Obtain the user information from the provider.
     *
     * @param  string  $provider
     * @return \Illuminate\Http\RedirectResponse
     */
    public function handleProviderCallback(string $provider): RedirectResponse
    {
        try {
            // Retrieve user details from the social provider
            $socialiteUser = Socialite::driver($provider)->user();

            // Check if a user with this social ID already exists
            $user = User::where('provider_id', $socialiteUser->getId())
                        ->where('provider_name', $provider)
                        ->first();

            if ($user) {
                // If user exists, log them in
                Auth::login($user);
                return redirect('/dashboard'); // Or wherever you want to redirect
            } else {
                // If user doesn't exist, create a new user
                // You might want to check for existing email or handle duplicate emails
                $existingUser = User::where('email', $socialiteUser->getEmail())->first();

                if ($existingUser) {
                    // If an existing user has this email but hasn't linked this provider yet,
                    // you might want to link the provider to their existing account.
                    // For simplicity, this example creates a new user if email is not found or is null.
                    // In a real app, you'd likely want to merge or prompt the user.
                    return redirect('/login')->withErrors(['social_login' => 'An account with this email already exists. Please login normally or link your social account.']);
                }

                $user = User::create([
                    'name' => $socialiteUser->getName() ?? $socialiteUser->getNickname() ?? 'User',
                    'email' => $socialiteUser->getEmail(),
                    'provider_id' => $socialiteUser->getId(),
                    'provider_name' => $provider,
                    'avatar' => $socialiteUser->getAvatar(),
                    'email_verified_at' => now(), // Assume email is verified by social provider
                    'password' => bcrypt(str()->random(16)), // Assign a random password, not used for social login
                ]);

                Auth::login($user);
                return redirect('/dashboard');
            }

        } catch (\Exception $e) {
            // Log the error for debugging purposes
            logger()->error('Socialite authentication failed: ' . $e->getMessage(), ['provider' => $provider]);
            return redirect('/login')->withErrors(['social_login' => 'Unable to authenticate with ' . ucfirst($provider) . '. Please try again.']);
        }
    }
}

// --- Minimal Configuration (`.env`) ---
// GITHUB_CLIENT_ID=your-github-client-id
// GITHUB_CLIENT_SECRET=your-github-client-secret
// GITHUB_REDIRECT_URI=http://localhost:8000/auth/github/callback

// --- Minimal Configuration (`config/services.php`) ---
// 'github' => [
//     'client_id' => env('GITHUB_CLIENT_ID'),
//     'client_secret' => env('GITHUB_CLIENT_SECRET'),
//     'redirect' => env('GITHUB_REDIRECT_URI'),
// ],

// --- Minimal Routes (`routes/web.php`) ---
// use App\Http\Controllers\Auth\SocialAuthController;

// Route::get('/auth/{provider}', [SocialAuthController::class, 'redirectToProvider'])->name('social.auth');
// Route::get('/auth/{provider}/callback', [SocialAuthController::class, 'handleProviderCallback']);

// --- User Model (`app/Models/User.php`) ---
// Add these fillable properties to your User model:
// protected $fillable = [
//     'name', 'email', 'password', 'provider_id', 'provider_name', 'avatar', 'email_verified_at'
// ];

// --- Migration (Example for adding social fields to users table) ---
// Schema::table('users', function (Blueprint $table) {
//     $table->string('provider_id')->nullable()->after('password');
//     $table->string('provider_name')->nullable()->after('provider_id');
//     $table->string('avatar')->nullable()->after('provider_name');
//     $table->index(['provider_id', 'provider_name']);
// });
```