PHPackages                             bigpaulie/laravel-social-passport - 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. bigpaulie/laravel-social-passport

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

bigpaulie/laravel-social-passport
=================================

Adds additional grant types to Laravel's Passport library

012PHP

Since Jan 11Pushed 8y ago1 watchersCompare

[ Source](https://github.com/bigpaulie/laravel-social-passport)[ Packagist](https://packagist.org/packages/bigpaulie/laravel-social-passport)[ RSS](/packages/bigpaulie-laravel-social-passport/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel social passport
=======================

[](#laravel-social-passport)

[![Build Status](https://camo.githubusercontent.com/af243b1f2cf1c029a47c75239e9f0eb888d23276917813551b59b70f186d3487/68747470733a2f2f7472617669732d63692e6f72672f6269677061756c69652f6c61726176656c2d736f6369616c2d70617373706f72742e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/bigpaulie/laravel-social-passport) [![Latest Stable Version](https://camo.githubusercontent.com/4e2cbef55e40db92c244ffb1ec0b10415f6b418db664f793254e091d47041dbd/68747470733a2f2f706f7365722e707567782e6f72672f6269677061756c69652f6c61726176656c2d736f6369616c2d70617373706f72742f762f737461626c65)](https://packagist.org/packages/bigpaulie/laravel-social-passport) [![Total Downloads](https://camo.githubusercontent.com/ef7d1c163a0fcafefb71c34635a7a7111b303a9d6f9dd0da41623c4f9ff427bb/68747470733a2f2f706f7365722e707567782e6f72672f6269677061756c69652f6c61726176656c2d736f6369616c2d70617373706f72742f646f776e6c6f616473)](https://packagist.org/packages/bigpaulie/laravel-social-passport) [![Latest Unstable Version](https://camo.githubusercontent.com/871b6fffa85540a7cb56d0ae5380a1ad19946895e1cb7cbe57a48d0563f8eff5/68747470733a2f2f706f7365722e707567782e6f72672f6269677061756c69652f6c61726176656c2d736f6369616c2d70617373706f72742f762f756e737461626c65)](https://packagist.org/packages/bigpaulie/laravel-social-passport) [![License](https://camo.githubusercontent.com/504ea6c14339db9f1e3f8f5be127b5db06a1b034417f068b4dbfb500b2b83606/68747470733a2f2f706f7365722e707567782e6f72672f6269677061756c69652f6c61726176656c2d736f6369616c2d70617373706f72742f6c6963656e7365)](https://packagist.org/packages/bigpaulie/laravel-social-passport) [![composer.lock](https://camo.githubusercontent.com/5cd294a8943566719b23322b972abe409aba47bf5050eff68b9628eab20bcdf7/68747470733a2f2f706f7365722e707567782e6f72672f6269677061756c69652f796969322d736f6369616c2d73686172652f636f6d706f7365726c6f636b)](https://packagist.org/packages/bigpaulie/laravel-social-passport)

This project is ideal for applications where the front-end is decoupled from the back-end such as vue.js, angular, cordova, etc. Providing stateless social authentication via Laravel's Passport library.

### Installation

[](#installation)

Install social passport via composer

```
  composer require bigpaulie/laravel-social-passport
```

Publish package resources.

```
php artisan vendor:publish
```

Run the migrations

```
php artisan migrate
```

### Supported networks

[](#supported-networks)

- Facebook

### Basic usage

[](#basic-usage)

By using the package I assume that you've already installed and configured laravel/passport package.

#### Facebook

[](#facebook)

At this moment I assume that your user table has a first\_name and a last\_name column, the migration file will automatically add a facebook\_id column.

Add the FacebookPassportProvider to you config/app.php providers array

```
\Bigpaulie\Laravel\Social\Passport\FacebookPassportProvider::class,
```

Add the SocialPassport contract to your user model.

```
use SocialPassport;
```

From this moment onward you are ready to use Facebook's access token to authenticate your users.

Send a POST request to oauth/token with the following body

```
{
	"grant_type": "facebook_login",
	"client_id": "",
	"client_secret": "",
	"facebook_token": ""
}
```

*Pay attention to the "grant\_type" key*

### Dependencies

[](#dependencies)

In order for this project to function properly some extra packages are needed.

- [facebook/graph-sdk](https://github.com/facebook/php-graph-sdk)
- [abraham/twitteroauth](https://github.com/abraham/twitteroauth)

### Road map

[](#road-map)

The following features will be added in the future.

- Twitter authentication
- Github authentication
- Google authentication
- Events

### Contributions

[](#contributions)

Contributions are most welcomed as long as you follow the existing code style and testing pattern.

Please feel free to fork, code and submit a pull request

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/1706d209e8e01305b6823045fac6d363e149abd14a4bd20397d237ea1107a2b4?d=identicon)[bigpaulie](/maintainers/bigpaulie)

---

Top Contributors

[![bigpaulie](https://avatars.githubusercontent.com/u/5903753?v=4)](https://github.com/bigpaulie "bigpaulie (28 commits)")

### Embed Badge

![Health badge](/badges/bigpaulie-laravel-social-passport/health.svg)

```
[![Health](https://phpackages.com/badges/bigpaulie-laravel-social-passport/health.svg)](https://phpackages.com/packages/bigpaulie-laravel-social-passport)
```

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