Skip to content
Easily add new or override built-in Laravel Socialite providers
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add PR & Issue templates Apr 8, 2016
src fix: guzzle config accept empty array not null. close #143 Apr 25, 2019
tests Tests initial refactoring Jan 16, 2019
.editorconfig Create .editorconfig Mar 29, 2016
.gitattributes Create .gitattributes Mar 29, 2016
.gitignore removed thumbs.db from gitignore Mar 27, 2016
.scrutinizer.yml Added .scrutinizer.yml and removed coverage file Feb 26, 2015
.travis.yml Update .travis.yml Sep 20, 2017
phpunit.xml.dist Update phpunit.xml.dist Mar 29, 2016

Socialite Providers Manager

Build Status Code Coverage Scrutinizer Code Quality Latest Stable Version Total Downloads Latest Unstable Version License Stories in Ready SensioLabsInsight


A package for Laravel Socialite that allows you to easily add new providers or override current providers.


  • You will have access to all of the providers that you load in using the manager.
  • Instantiation is deferred until Socialite is called
  • You can override current providers
  • You can create new providers
  • Lumen usage is easy
  • stateless() can be set to true or false
  • You can override a config dynamically
  • It retrieves environment variables directly from the .env file instead of also having to configure the services array.

Available Providers


Creating a Handler

Below is an example handler. You need to add this full class name to the listen[] in the EventServiceProvider.

namespace Your\Name\Space;

use SocialiteProviders\Manager\SocialiteWasCalled;

class ProviderNameExtendSocialite
    public function handle(SocialiteWasCalled $socialiteWasCalled)
        $socialiteWasCalled->extendSocialite('providername', \Your\Name\Space\Provider::class);

Creating a Provider

Overriding a Built-in Provider

You can easily override a built-in laravel/socialite provider by creating a new one with exactly the same name (i.e. 'facebook').

Dynamically Passing a Config

You can dynamically pass a config by using:

$clientId = "secret";
$clientSecret = "secret";
$redirectUrl = "";
$additionalProviderConfig = ['site' => ''];
$config = new \SocialiteProviders\Manager\Config($clientId, $clientSecret, $redirectUrl, $additionalProviderConfig);
return Socialite::with('provider-name')->setConfig($config)->redirect();

You must call this before you run any Socialite methods.

Creating an OAuth1 Server Class

Take a look at the other OAuth1 providers for inspiration.

Getting the Access Token Response Body

Laravel Socialite by default only allows access to the access_token. Which can be accessed via the \Laravel\Socialite\User->token public property. Sometimes you need access to the whole response body which may contain items such as a refresh_token.

To make this possible, the OAuth2 provider class needs to extend \SocialiteProviders\Manager\OAuth2\AbstractProvider and OAuth1 providers need to utilize the \SocialiteProviders\Manager\OAuth1\AbstractProvider and \SocialiteProviders\Manager\OAuth1\Server.

You can access it from the user object like so: $user->accessTokenResponseBody

You can’t perform that action at this time.