kuainiu/laravel-kuainiu

API client wrapper for Laravel & Connect provider for Laravel Socialite

Laravel-Kuainiu

Laravel-Kuainiu incorporates Kuainiu Connect and the Kuainiu API into your Laravel, _(*1)

Requirements

• Laravel Socialite (if you intend on using Kuainiu Connect)

Installation

Add Laravel-Kuainiu to your composer file via the composer require command:, _(*2)

$ composer require kuainiu/laravel-kuainiu

Or add it to composer.json manually:, _(*3)

"require": {
    "kuainiu/laravel-kuainiu": "~1.0"
}

Configuration

To get started, you'll need to publish all vendor assets:, _(*4)

$ php artisan vendor:publish --provider="Kuainiu\KuainiuServiceProvider"

This will create a config/kuainiu.php file in your app that you can modify to set your configuration., _(*5)

Kuainiu PAssport Connect with Laravel Socialite

If you intend on using Kuainiu Connect, update config/services.php by adding this to the array:, _(*6)

'kuainiu' => [
    'oauthServerDomain' => env('KUAINIU_OAUTH_DOMAIN'),
    'client_id'         => env('KUAINIU_CLIENT_ID', 'app_xxx'),
    'client_secret'     => env('KUAINIU_CLIENT_SECRET'),
    'redirect'          => env('KUAINIU_REDIRECT_URI'),
],

To make sure Laravel Socialite can actually find the Kuainiu driver, use the following code snippet and paste it in the boot() method from your AppServiceProvider.php., _(*7)

Socialite::extend('kuainiu', function ($app) {
    $config = $app['config']['services.kuainiu'];

    return Socialite::buildProvider('Kuainiu\KuainiuConnectProvider', $config);
});

Usage

Here you can see an example of just how simple this package is to use., _(*8)

Kuainiu API

$user = Kuainiu::api()->user()->create([
    "name"      => 'user_name_',
    "mobile" => "13800138000"
]);

$user = Kuainiu::createUser(['name'=>'name']);

if ($user->isCreated())
{
    echo "User Created.";
}

Kuainiu Passport Connect with Laravel Socialite

Route::get('login', function () {
    return Socialite::with('kuainiu')
        ->scopes('profiles.read profiles.write') // Additional permission: profiles.read profiles.write(the string need space separator)
        ->redirect();
});

Route::get('kuainiu/user/auth', function () {
    $user = Socialite::with('kuainiu')->stateless()->user();
    dd($user);
});

License

Copyright (c) 2018, Kuainiu Group, _(*9)