PHPackages                             v-imarcom/manager-ingress - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. v-imarcom/manager-ingress

ActiveLibrary[Authentication &amp; Authorization](/categories/authentication)

v-imarcom/manager-ingress
=========================

Easily add new or override built-in providers in Laravel Socialite.

v4.0.2(4y ago)0791MITPHPPHP ^7.2 || ^8.0

Since Feb 19Pushed 4y agoCompare

[ Source](https://github.com/vicklamarreimarcom/Manager)[ Packagist](https://packagist.org/packages/v-imarcom/manager-ingress)[ Docs](https://socialiteproviders.com)[ RSS](/packages/v-imarcom-manager-ingress/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (4)Versions (65)Used By (1)

Socialite Providers Manager
===========================

[](#socialite-providers-manager)

[![Build Status](https://camo.githubusercontent.com/bea30df6ea43693c5a77261bbff06044b669d5ff17421002dfeca90c4f22cc79/68747470733a2f2f7472617669732d63692e6f72672f536f6369616c69746550726f7669646572732f4d616e616765722e737667)](https://travis-ci.org/SocialiteProviders/Manager)[![codecov](https://camo.githubusercontent.com/63f57da01e8fad1b7947e543563db95e269d8889a8c338f6a7389b64d4aef8d6/68747470733a2f2f636f6465636f762e696f2f67682f536f6369616c69746550726f7669646572732f4d616e616765722f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/SocialiteProviders/Manager)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/5ec1892dac72225aa85c70d55a7bfea7ca5a34256ac767fc4beebfeaefb8f6c0/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f536f6369616c69746550726f7669646572732f4d616e616765722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/SocialiteProviders/Manager/?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/ed1f97c955b58ce7913217102bcdd82791ea3c28cc7fdca448c69eb8ed6db165/68747470733a2f2f706f7365722e707567782e6f72672f736f6369616c69746570726f7669646572732f6d616e616765722f762f737461626c652e737667)](https://packagist.org/packages/socialiteproviders/manager)[![Total Downloads](https://camo.githubusercontent.com/8234e7570a9dfe78203a7e74ef7dd2833f69edc0e18fa96dc36f7bc96198633e/68747470733a2f2f706f7365722e707567782e6f72672f736f6369616c69746570726f7669646572732f6d616e616765722f646f776e6c6f6164732e737667)](https://packagist.org/packages/socialiteproviders/manager)[![Latest Unstable Version](https://camo.githubusercontent.com/9f5a79bc03d3209e0dfbc98a2097f6f076dce116119d1702e51d1604b97568f5/68747470733a2f2f706f7365722e707567782e6f72672f736f6369616c69746570726f7669646572732f6d616e616765722f762f756e737461626c652e737667)](https://packagist.org/packages/socialiteproviders/manager)[![License](https://camo.githubusercontent.com/ea6f9ac045da4e067c4daa11bc6558441c7347b9d2d14485ee80d4caf9466b9e/68747470733a2f2f706f7365722e707567782e6f72672f736f6369616c69746570726f7669646572732f6d616e616765722f6c6963656e73652e737667)](https://packagist.org/packages/socialiteproviders/manager)[![StyleCI](https://camo.githubusercontent.com/2f52dccb7ed9951cd7fc72ceefcaa52dca4681d32fa55e97741bd6db984ee39d/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f33303939333530342f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/30993504?branch=master)[![SensioLabsInsight](https://camo.githubusercontent.com/e7feb8129aa87daecd1fd1d89ff377ed1a20de1299ffa4e323fa6ebc3d517131/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f64646232663064662d366438352d343331632d386536382d3631363462303864643835322f736d616c6c2e706e67)](https://insight.sensiolabs.com/projects/ddb2f0df-6d85-431c-8e68-6164b08dd852)

About
-----

[](#about)

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

### Benefits

[](#benefits)

- 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
-------------------

[](#available-providers)

- See the [SocialiteProviders](https://socialiteproviders.com/) list
- You can also make your own or modify someone else's

Reference
---------

[](#reference)

- [Laravel docs about events](https://laravel.com/docs/7.x/events)
- [Laracasts video on events in Laravel 5](https://laracasts.com/lessons/laravel-5-events)
- [Laravel Socialite Docs](https://github.com/laravel/socialite)
- [Laracasts Socialite video](https://laracasts.com/series/whats-new-in-laravel-5/episodes/9)

Creating a Handler
------------------

[](#creating-a-handler)

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

- [See also the Laravel docs about events](https://laravel.com/docs/7.x/events).
- `providername` is the name of the provider such as `meetup`.
- You will need to change your the namespacing and class names of course.

```
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
-------------------

[](#creating-a-provider)

- Look at the already created [providers](https://socialiteproviders.netlify.app/) for inspiration.
- [See this article on Medium](https://medium.com/@morrislaptop/adding-auth-providers-to-laravel-socialite-ca0335929e42)

Overriding a Built-in 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
----------------------------

[](#dynamically-passing-a-config)

You can dynamically pass a config by using:

```
$clientId = "secret";
$clientSecret = "secret";
$redirectUrl = "http://yourdomain.com/api/redirect";
$additionalProviderConfig = ['site' => 'meta.stackoverflow.com'];
$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
-------------------------------

[](#creating-an-oauth1-server-class)

Take a look at the other [OAuth1 providers](https://socialiteproviders.netlify.app/) for inspiration.

Getting the Access Token Response Body
--------------------------------------

[](#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`

###  Health Score

35

—

LowBetter than 79% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 51.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~39 days

Recently: every ~163 days

Total

64

Last Release

1602d ago

Major Versions

0.1.10 → 1.0.02015-06-18

1.2.4 → v2.0.02016-03-29

v2.2.1 → v3.0.02017-01-25

v2.3 → v3.4.32019-09-25

v3.6 → v4.0.02020-10-20

PHP version history (5 changes)0.1PHP &gt;=5.4.0

1.0.0PHP &gt;=5.5.0

v2.0.0PHP ^5.6 || ^7.0

v3.6PHP ^7.2

v4.0.1PHP ^7.2 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/641c9b7f540f92a657b0dc386984cd9c3905cb455acaac483f7d18a5679347cc?d=identicon)[vicklamarreimarcom](/maintainers/vicklamarreimarcom)

---

Top Contributors

[![AndyWendt](https://avatars.githubusercontent.com/u/6130713?v=4)](https://github.com/AndyWendt "AndyWendt (95 commits)")[![faustbrian](https://avatars.githubusercontent.com/u/22145591?v=4)](https://github.com/faustbrian "faustbrian (31 commits)")[![lucasmichot](https://avatars.githubusercontent.com/u/513603?v=4)](https://github.com/lucasmichot "lucasmichot (8 commits)")[![vicklamarreimarcom](https://avatars.githubusercontent.com/u/96548435?v=4)](https://github.com/vicklamarreimarcom "vicklamarreimarcom (7 commits)")[![atymic](https://avatars.githubusercontent.com/u/50683531?v=4)](https://github.com/atymic "atymic (6 commits)")[![antonkomarev](https://avatars.githubusercontent.com/u/1849174?v=4)](https://github.com/antonkomarev "antonkomarev (5 commits)")[![AmrSoliman](https://avatars.githubusercontent.com/u/3324468?v=4)](https://github.com/AmrSoliman "AmrSoliman (2 commits)")[![draperstudio](https://avatars.githubusercontent.com/u/257012927?v=4)](https://github.com/draperstudio "draperstudio (2 commits)")[![ethanransdellrarebird](https://avatars.githubusercontent.com/u/48797338?v=4)](https://github.com/ethanransdellrarebird "ethanransdellrarebird (2 commits)")[![m1guelpf](https://avatars.githubusercontent.com/u/23558090?v=4)](https://github.com/m1guelpf "m1guelpf (2 commits)")[![pilot911](https://avatars.githubusercontent.com/u/4451709?v=4)](https://github.com/pilot911 "pilot911 (2 commits)")[![sander3](https://avatars.githubusercontent.com/u/15908302?v=4)](https://github.com/sander3 "sander3 (2 commits)")[![seanmangar](https://avatars.githubusercontent.com/u/6080053?v=4)](https://github.com/seanmangar "seanmangar (2 commits)")[![shaunthegeek](https://avatars.githubusercontent.com/u/4971414?v=4)](https://github.com/shaunthegeek "shaunthegeek (2 commits)")[![litvinchuk](https://avatars.githubusercontent.com/u/3016592?v=4)](https://github.com/litvinchuk "litvinchuk (1 commits)")[![g-plane](https://avatars.githubusercontent.com/u/17216317?v=4)](https://github.com/g-plane "g-plane (1 commits)")[![lukepolo](https://avatars.githubusercontent.com/u/2066668?v=4)](https://github.com/lukepolo "lukepolo (1 commits)")[![c00p3r](https://avatars.githubusercontent.com/u/5259532?v=4)](https://github.com/c00p3r "c00p3r (1 commits)")[![mikemclin](https://avatars.githubusercontent.com/u/1570155?v=4)](https://github.com/mikemclin "mikemclin (1 commits)")[![morloderex](https://avatars.githubusercontent.com/u/5677808?v=4)](https://github.com/morloderex "morloderex (1 commits)")

---

Tags

laraveloauthmanagerproviderssocialite

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/v-imarcom-manager-ingress/health.svg)

```
[![Health](https://phpackages.com/badges/v-imarcom-manager-ingress/health.svg)](https://phpackages.com/packages/v-imarcom-manager-ingress)
```

###  Alternatives

[socialiteproviders/manager

Easily add new or override built-in providers in Laravel Socialite.

42442.0M544](/packages/socialiteproviders-manager)[kovah/laravel-socialite-oidc

OpenID Connect OAuth2 Provider for Laravel Socialite

2073.7k](/packages/kovah-laravel-socialite-oidc)[mmanos/laravel-social

A social login package for Laravel 4.

556.8k](/packages/mmanos-laravel-social)[socialiteproviders/kakao

Kakao OAuth2 Provider for Laravel Socialite

10484.7k4](/packages/socialiteproviders-kakao)[truckersmp/steam-socialite

Laravel Socialite provider for Steam OpenID.

1516.7k](/packages/truckersmp-steam-socialite)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
