README

Laravel-Kuainiu incorporates Kuainiu Connect and the Kuainiu API into your Laravel

Requirements

Laravel Socialite (if you intend on using Kuainiu Connect)

Installation

Add Laravel-Kuainiu to your composer file via the composer require command:

$ composer require kuainiu/laravel-kuainiu

Or add it to composer.json manually:

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

Configuration

To get started, you'll need to publish all vendor assets:

$ 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.

Kuainiu PAssport Connect with Laravel Socialite

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

'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.

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.

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);
});

kuainiu / laravel-kuainiu

Maintainers

Details