Socialite for Discord

Overzicht

revolution/socialite-discord is een driverpakket waarmee je Discord OAuth2-authenticatie kunt gebruiken met Laravel Socialite. De ingebouwde providers van Laravel Socialite bevatten geen Discord. Door alleen dit pakket te installeren kun je Discord-login met Socialite::driver('discord') aan je app toevoegen.

Voor het gebruik van Laravel Socialite zelf, zie de Socialite-gids.

Installatie

composer require revolution/socialite-discord

Configuratie

Registreer je app in het Discord Developer Portal

Maak een applicatie aan in het Discord Developer Portal en haal in de sectie OAuth2 de Client ID en Client Secret op. Voeg bij Redirects je callback-URL toe (bijvoorbeeld https://example.com/auth/discord/callback).

config/services.php

'discord' => [
    'client_id'     => env('DISCORD_CLIENT_ID'),
    'client_secret' => env('DISCORD_CLIENT_SECRET'),
    'redirect'      => env('DISCORD_REDIRECT'),
],

.env

DISCORD_CLIENT_ID=your-client-id
DISCORD_CLIENT_SECRET=your-client-secret
DISCORD_REDIRECT=https://example.com/auth/discord/callback

Basisgebruik

Definieer de routes

Voeg twee routes toe aan routes/web.php: één voor de redirect en één voor de callback.

use App\Http\Controllers\SocialiteController;

Route::get('auth/discord', [SocialiteController::class, 'login']);
Route::get('auth/discord/callback', [SocialiteController::class, 'callback']);

Maak de controller

<?php

namespace App\Http\Controllers;

use Laravel\Socialite\Facades\Socialite;

class SocialiteController extends Controller
{
    public function login()
    {
        return Socialite::driver('discord')->redirect();
    }

    public function callback()
    {
        $discordUser = Socialite::driver('discord')->user();

        // $discordUser->getId()        Discord-gebruikers-ID
        // $discordUser->getName()      Gebruikersnaam
        // $discordUser->getEmail()     E-mailadres (email-scope vereist)
        // $discordUser->getAvatar()    Avatar-URL
        // $discordUser->token          Access token

        $user = \App\Models\User::updateOrCreate(
            ['discord_id' => $discordUser->getId()],
            ['name' => $discordUser->getName()]
        );

        \Illuminate\Support\Facades\Auth::login($user);

        return redirect('/dashboard');
    }
}

Scopes instellen

Bij Discord OAuth2 geef je met scopes aan welke rechten je opvraagt. De standaardscope is alleen identify.

public function login()
{
    return Socialite::driver('discord')
                    ->setScopes(['identify', 'email', 'guilds', 'guilds.join'])
                    ->redirect();
}

Overzicht van de belangrijkste scopes:

Scope	Informatie die je krijgt
`identify`	Gebruikers-ID, gebruikersnaam, avatar (standaard)
`email`	E-mailadres
`guilds`	Lijst van servers waar de gebruiker lid van is
`guilds.join`	Recht om de gebruiker aan een server toe te voegen

Alle scopes vind je in de Discord OAuth2-documentatie.

Gebruikers opslaan en inloggen

Een typisch implementatievoorbeeld waarbij je in de callback-route de gebruikersinformatie ophaalt, in de database opslaat en vervolgens inlogt.

use App\Models\User;
use Illuminate\Support\Facades\Auth;
use Laravel\Socialite\Facades\Socialite;

public function callback()
{
    $discordUser = Socialite::driver('discord')->user();

    $user = User::updateOrCreate(
        ['discord_id' => $discordUser->getId()],
        [
            'name'          => $discordUser->getName(),
            'email'         => $discordUser->getEmail(),
            'discord_token' => $discordUser->token,
        ]
    );

    Auth::login($user);

    return redirect('/dashboard');
}

Om email op te halen is de email-scope nodig. Als je die scope niet opgeeft, kan getEmail() null teruggeven.

Vergelijking met andere Socialite-drivers

Dit pakket is op de reguliere manier geïmplementeerd via Socialite::extend() en gebruik je met exact dezelfde API als de ingebouwde providers. Voor de werking van custom providers en de details van Socialite::extend(), zie de Socialite-gids.

Raadpleeg de GitHub-repository voor de laatste informatie.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Overzicht

Installatie

Configuratie

Registreer je app in het Discord Developer Portal

config/services.php

.env

Basisgebruik

Scopes instellen

Gebruikers opslaan en inloggen

Vergelijking met andere Socialite-drivers

​Overzicht

​Installatie

​Configuratie

​Registreer je app in het Discord Developer Portal

​config/services.php

​.env

​Basisgebruik

​Scopes instellen

​Gebruikers opslaan en inloggen

​Vergelijking met andere Socialite-drivers

Overzicht

Installatie

Configuratie

Registreer je app in het Discord Developer Portal

config/services.php

.env

Basisgebruik

Scopes instellen

Gebruikers opslaan en inloggen

Vergelijking met andere Socialite-drivers