PHPackages zfort/social-auth - 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 & Authorization](/categories/authentication) 4. / 5. zfort/social-auth Abandoned → [mad-web/laravel-social-auth](/?search=mad-web%2Flaravel-social-auth)ArchivedLibrary[Authentication & Authorization](/categories/authentication) zfort/social-auth ================= Easy social auth integration with a lot of available providers 036PHP Since Aug 2Pushed 7y ago5 watchersCompare [ Source](https://github.com/zfort/social-auth)[ Packagist](https://packagist.org/packages/zfort/social-auth)[ RSS](/packages/zfort-social-auth/feed)WikiDiscussions master Synced 2mo ago READMEChangelogDependenciesVersions (1)Used By (0) Social Authentication ===================== [](#social-authentication) [![Latest Version on Packagist](https://camo.githubusercontent.com/4e5c1908aac4ea62ed538dbd7de04a589c02d5362d3ff2df9e3394adf1790d9b/68747470733a2f2f706f7365722e707567782e6f72672f7a666f72742f736f6369616c2d617574682f762f737461626c652e7376673f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/zfort/social-auth)[![Software License](https://camo.githubusercontent.com/1e4ba7d777d4e8d694158d2870f603740bf59b6da8ef5c65099b9759666e4f5c/68747470733a2f2f706f7365722e707567782e6f72672f7a666f72742f736f6369616c2d617574682f6c6963656e73653f666f726d61743d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/cbcda556535b9ccad5062ddca9973e9f7a625e5772bbd3094a4d9b919f8d4c1c/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f7a666f72742f736f6369616c2d617574682f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/zfort/social-auth)[![StyleCI](https://camo.githubusercontent.com/ef9d6024305ca902e2e369070888cc97fc69b2ea3a10ac9ba795e9d0c5185293/68747470733a2f2f7374796c6563692e696f2f7265706f732f33333931363835302f736869656c64)](https://styleci.io/repos/86463317)[![Quality Score](https://camo.githubusercontent.com/939048095c606e3f137478d5b966b032ee5c11cb9bf51d9a892beb995b2e9f4a/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f7a666f72742f736f6369616c2d617574682e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/zfort/social-auth)[![Total Downloads](https://camo.githubusercontent.com/6a26dae226ecf843d8b53ec8d2576057f72996c374020e11b4847bd1b6876f34/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7a666f72742f736f6369616c2d617574682e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/zfort/social-auth) This package give ability to - Sign In - Sign Up - Attach/Detach social network provider to the existing account Install ------- [](#install) Via Composer ``` $ composer require zfort/social-auth ``` Now add the service provider in config/app.php file: ``` 'providers' => [ // ... ZFort\SocialAuth\SocialAuthServiceProvider::class, ]; ``` You can publish the migration with: ``` $ php artisan vendor:publish --provider="ZFort\SocialAuth\SocialAuthServiceProvider" --tag="migrations" ``` The package assumes that your users table name is called "users". If this is not the case you should manually edit the published migration to use your custom table name. After the migration has been published you can create the social\_providers table for storing supported providers and user\_has\_social\_provider pivot table by running the migrations: ``` $ php artisan migrate ``` You can publish the config-file with: ``` $ php artisan vendor:publish --provider="ZFort\SocialAuth\SocialAuthServiceProvider" --tag="config" ``` This is the contents of the published config/social-auth.php config file: ``` return [ /* |-------------------------------------------------------------------------- | Additional service providers |-------------------------------------------------------------------------- | | The social providers listed here will enable support for additional social | providers which provided by https://socialiteproviders.github.io/ just | add new event listener from the installation guide | */ 'providers' => [ // ], 'models' => [ /* * When using the "UserSocialite" trait from this package, we need to know which * Eloquent model should be used to retrieve your available social providers. Of course, it * is often just the "SocialProvider" model but you may use whatever you like. */ 'social' => \ZFort\SocialAuth\Models\SocialProvider::class, /* * User model which you will use as "SocialAuthenticatable" */ 'user' => \App\User::class, ], 'table_names' => [ /* |-------------------------------------------------------------------------- | Users Table |-------------------------------------------------------------------------- | | The table for storing relation between users and social providers. Also there is | a place for saving "user social network id", "token", "expiresIn" if it exist | */ 'user_has_social_provider' => 'user_has_social_provider', /* |-------------------------------------------------------------------------- | Social Providers Table |-------------------------------------------------------------------------- | | The table that contains all social network providers which your application use. | */ 'social_providers' => 'social_providers' ], 'foreign_keys' => [ /* * The name of the foreign key to the users table. */ 'users' => 'user_id', /* * The name of the foreign key to the socials table */ 'socials' => 'social_id' ], /* |-------------------------------------------------------------------------- | Authentication redirection |-------------------------------------------------------------------------- | | Redirect path after success/error login via social network | */ 'redirect' => '/home' ]; ``` Or you can publish and modify view templates with: ``` $ php artisan vendor:publish --provider="ZFort\SocialAuth\SocialAuthServiceProvider" --tag="views" ``` Also you can publish and modify translation file: ``` $ php artisan vendor:publish --provider="ZFort\SocialAuth\SocialAuthServiceProvider" --tag="lang" ``` ##### Add credetials to your project [](#add-credetials-to-your-project) File .env ``` FB_ID = FB_SECRET = FB_REDIRECT = /social/facebook/callback GOOGLE_ID = GOOGLE_SECRET = GOOGLE_REDIRECT = /social/google/callback GITHUB_ID = GITHUB_SECRET = GITHUB_REDIRECT = /social/github/callback ``` File config/services.php ``` 'facebook' => [ 'client_id' => env('FB_ID'), 'client_secret' => env('FB_SECRET'), 'redirect' => env('FB_REDIRECT') ], 'google' => [ 'client_id' => env('GOOGLE_ID'), 'client_secret' => env('GOOGLE_SECRET'), 'redirect' => env('GOOGLE_REDIRECT') ], 'github' => [ 'client_id' => env('GITHUB_ID'), 'client_secret' => env('GITHUB_SECRET'), 'redirect' => env('GITHUB_REDIRECT') ] ``` After that, create your social providers in the database ``` SocialProvider::create(['label' => 'Facebook', 'slug' => 'facebook']); SocialProvider::create(['label' => 'Google', 'slug' => 'google']); SocialProvider::create(['label' => 'github', 'slug' => 'Github']); ``` Or add rows directly You can add additional scopes and parameters to the social auth request ``` SocialProvider::create([ 'label' => 'github', 'slug' => 'Github', 'scopes' => ['foo', 'bar'], 'parameters' => ['foo' => 'bar'] ]); ``` To override default scopes ``` $SocialProvider->setScopes(['foo', 'bar'], true); ``` ##### Include social buttons into your templates [](#include-social-buttons-into-your-templates) ``` @include('social-auth::attach') // for authenticated user to attach/detach another socials @include('social-auth::buttons') // for guests to login via ``` ##### Prepare your user model [](#prepare-your-user-model) Implement SocialAuthenticatable interface Add UserSocialite trait to your User model ``` namespace App\Models; use Illuminate\Database\Eloquent\Model; use ZFort\SocialAuth\Traits\UserSocialite; use ZFort\SocialAuth\Contracts\SocialAuthenticatable; class User extends Model implements SocialAuthenticatable { use UserSocialite; ... } ``` ##### Routes [](#routes) If you need do some custom with social flow, you should define yourself controllers and put your custom url into routes file. For example ``` Route::get('social/{social}', 'Auth\SocialAuthController@getAccount'); Route::get('social/{social}/callback', 'Auth\SocialAuthController@callback'); Route::get('social/{social}/detach', 'SocialAuthController@deleteAccount'); ``` In case if you no need any special functionality ypu can use our default controllers ##### Customize for your project [](#customize-for-your-project) ###### Custom User Model [](#custom-user-model) User model we takes from the config('social-auth.models.user'); ###### User Fields Mapping [](#user-fields-mapping) SocialAuthenticatable interface contains method `mapSocialData` for mapping social fields for user model If you need you can redefine this method for your preferences project in your UserModel Change log ---------- [](#change-log) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Testing ------- [](#testing) ``` $ composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [zFort](https://zfort.com) - [All Contributors](link-contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 20 — LowBetter than 14% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community5 Small or concentrated contributor base Maturity41 Maturing project, gaining track record 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/168def029554d2e57e1bfeadf4a4dcf38152d6415d3b171823a2e1145feb53ed?d=identicon)[Slava Razum](/maintainers/Slava%20Razum) ### Embed Badge ![Health badge](/badges/zfort-social-auth/health.svg) ``` [![Health](https://phpackages.com/badges/zfort-social-auth/health.svg)](https://phpackages.com/packages/zfort-social-auth) ``` ### Alternatives [namshi/jose JSON Object Signing and Encryption library for PHP. 1.8k99.6M101](/packages/namshi-jose)[league/oauth1-client OAuth 1.0 Client Library 99698.8M106](/packages/league-oauth1-client)[bezhansalleh/filament-shield Filament support for `spatie/laravel-permission`. 2.8k2.9M88](/packages/bezhansalleh-filament-shield)[gesdinet/jwt-refresh-token-bundle Implements a refresh token system over Json Web Tokens in Symfony 70516.4M35](/packages/gesdinet-jwt-refresh-token-bundle)[league/oauth2-google Google OAuth 2.0 Client Provider for The PHP League OAuth2-Client 41721.2M118](/packages/league-oauth2-google)[illuminate/auth The Illuminate Auth package. 9327.3M1.0k](/packages/illuminate-auth) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)