freebuu/socialite-local

Socialite provider for local development

v0.1.1-alpha 2023-10-01 19:22 UTC

Requires

• php: ^7.4 || ^8.0
• illuminate/cache: ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10
• illuminate/support: ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10
• laravel/socialite: ~4.0 || ~5.0

MIT

• Maksim

• oauth
• laravel
• socialite
• laravel socialite
• local develop

README

Introduction

The library is used to simulate an OAuth server locally. All calls to the Socialite are intercepted and replaced by a local driver. Only installation is enough to use - no additional configuration in most cases.

Installation

• Require Socialite v4 or v5 and OAuth2 provider (OAuth1 providers not supported for now)
• Use Composer to install: composer require --dev freebuu/socialite-local

⚠️ WARNING: install this package only as dev dependency due to security reasons.

Usage

Just use socialite as usual:

Socialite::driver('github')->redirect()

You will be redirected to local page - where you can set email, username, id, etc. for subject. After submitting form you can get socialite user as usual - with previously entered data.

Socialite::driver('github')->user()

Additional configuration

Server response

If you need to imitate user structure from server - it can be achieved with afterResolving callback

public function register()
{
    $this->app->afterResolving('socialite_local.subject_repository', function ($r){
        $r->setUserCallback(function ($data){
            //data is array coming from login form
            //return array with user info
            return [
                'id' => $data['id'] ?? random_int(1000, 10000),
                'uuid' => $data['uuid'] ?? vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex(random_bytes(16)), 4)),
                'email' => $email = $data['email'],
                'username' => $data['username'] ?? $email,
                'name' => $data['name'] ?? mb_substr($email, 0, strpos($email, '@')) . '_name',
            ];
        });
    });
}

User mapper

By default, library use original driver mapper - to map server answer to User model. You can disable this behavior by setting SOCIALITE_LOCAL_USE_ORIGINAL_MAPPER to false