> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Socialite for Discord

> Een driverpakket om Discord OAuth2-authenticatie te implementeren met Laravel Socialite.

## Overzicht

[revolution/socialite-discord](https://github.com/invokable/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.

<Info>
  Voor het gebruik van Laravel Socialite zelf, zie de [Socialite-gids](/nl/socialite).
</Info>

## Installatie

```shell theme={null}
composer require revolution/socialite-discord
```

## Configuratie

### Registreer je app in het Discord Developer Portal

Maak een applicatie aan in het [Discord Developer Portal](https://discord.com/developers/applications) 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

```php theme={null}
'discord' => [
    'client_id'     => env('DISCORD_CLIENT_ID'),
    'client_secret' => env('DISCORD_CLIENT_SECRET'),
    'redirect'      => env('DISCORD_REDIRECT'),
],
```

### .env

```dotenv theme={null}
DISCORD_CLIENT_ID=your-client-id
DISCORD_CLIENT_SECRET=your-client-secret
DISCORD_REDIRECT=https://example.com/auth/discord/callback
```

## Basisgebruik

<Steps>
  <Step title="Definieer de routes">
    Voeg twee routes toe aan `routes/web.php`: één voor de redirect en één voor de callback.

    ```php theme={null}
    use App\Http\Controllers\SocialiteController;

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

  <Step title="Maak de controller">
    ```php theme={null}
    <?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');
        }
    }
    ```
  </Step>
</Steps>

## Scopes instellen

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

```php theme={null}
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 |

<Tip>
  Alle scopes vind je in de [Discord OAuth2-documentatie](https://discord.com/developers/docs/topics/oauth2#shared-resources-oauth2-scopes).
</Tip>

## Gebruikers opslaan en inloggen

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

```php theme={null}
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');
}
```

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

## 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](/nl/socialite).

<Info>
  Raadpleeg de [GitHub-repository](https://github.com/invokable/socialite-discord) voor de laatste informatie.
</Info>


## Related topics

- [我的包](/zh-CN/packages/index.md)
- [Laravel Socialite (sociale authenticatie)](/nl/socialite.md)
- [Laravel Notification for Discord(Webhook)](/nl/packages/laravel-notification-discord-webhook.md)
- [Socialite - Laravel Bluesky](/nl/packages/laravel-bluesky/socialite.md)
- [Tutorial - Laravel Console Starter](/nl/packages/laravel-console-starter/tutorial.md)