Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/socialite-manager/socialite

[Social login]Socialite is an OAuth1/OAuth2 Authentication tool.
https://github.com/socialite-manager/socialite

bitbucket facebook github google linkedin oauth-login php sosial twitter

Last synced: about 2 months ago
JSON representation

[Social login]Socialite is an OAuth1/OAuth2 Authentication tool.

Awesome Lists containing this project

README

        

# Socialite

[![MIT License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE)

## Introduction

This is inspired by laravel/socialite, you can easily use it without Laravel.

It possible to use it with various frameworks and middleware.

It is compatible with laravel/socialite.
You can check the [Document](https://laravel.com/docs/5.5/socialite) of laravel.

## Core Providers

* twitter
* github
* google
* facebook
* bitbucket
* linkedin

## other Providers

* [Instagram](https://github.com/socialite-manager/Instagram-Provider)
* [Line](https://github.com/socialite-manager/Line-Provider)
* [VKontakte](https://github.com/socialite-manager/VKontakte-Provider)
* [Weixin](https://github.com/socialite-manager/Weixin-Provider)
* [QQ](https://github.com/socialite-manager/QQ-Provider)
* [Weibo](https://github.com/socialite-manager/Weibo-Provider)
* [Twitch](https://github.com/socialite-manager/Twitch-Provider)
* [Slack](https://github.com/socialite-manager/Slack-Provider)
* [Discord](https://github.com/socialite-manager/Discord-Provider)
* [Dropbox](https://github.com/socialite-manager/Dropbox-Provider)
* [Yahoo](https://github.com/socialite-manager/Yahoo-Provider)
* [Spotify](https://github.com/socialite-manager/Spotify-Provider)
* [GitLab](https://github.com/socialite-manager/GitLab-Provider)
* [Yandex](https://github.com/socialite-manager/Yandex-Provider)
* Add more...

## Requirement

```
PHP >= 7.0
```

## Installation

```
composer require socialite-manager/socialite
```

## Basic Usage

```php
$config = [
'client_id' => 'xxx',
'client_secret' => 'xxx',
'redirect' => 'http://example.com/callback.php',
];
```

`oath.php`

```php
use Socialite\Socialite;

Socialite::driver('twitter', $config)->redirect();
```

`callback.php`

```php
use Socialite\Socialite;

$user = Socialite::driver('twitter', $config)->user();

$user->getAvatar();
$user->getEmail();
$user->getId();
$user->getNickname();
$user->getName();
```

## Advanced Usage

`Sosialite` have options for use with framework and middleware

### Set Request

Interface: `\Psr\Http\Message\ServerRequestInterface`

```php
Socialite::driver('twitter', $config)
->setRequest($this->request);
```

### Set Session

need one of the following `read/write` interfaces.

|write|
|----|
|`$session->put()`|
|`$session->set()`|
|`$session->write()`|

|read|
|----|
|`$session->get()`|
|`$session->read()`|

```php
Socialite::driver('twitter', $config)
->setSession($this->request->getSession());
```

### Redirect psr7 response

`Psr\Http\Message\ResponseInterface` will be returned

```
Socialite::driver('twitter', $config)->psr7Redirect()
```