bkpsdm-karawang/sim-asn-php-client

PHP Client for SIM-ASN Service BKPSDM Karawang

3.0.2 2024-08-06 06:25 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.0
• illuminate/database: ^10|^11
• illuminate/http: ^10|^11
• illuminate/pagination: ^10|^11
• illuminate/support: ^10|^11

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3
• laravel/framework: ^10|^11

MIT

• Denma Syarikin

• sim asn
• bkpsdm
• karawang

README

This is php client SDK for SIM-ASN BKPSDM Kabupaten Karawang api services

Installation

require this package via composer

composer require bkpsdm-karawang/sim-asn-php-client

add environment value to .env

SIM_ASN_CLIENT_ID=xxxx
SIM_ASN_CLIENT_SECRET=xxxx

We recomend add two field to user table

    $table->uuid('sim_asn_user_id')->nullable()->default(null);
    $table->json('sim_asn_token')->nullable()->default(null);

Add refresh token handler in boot of AppServiceProvider.php

    use SIM_ASN\Laravel\Facades\UserClient;
    use SIM_ASN\Models\AccessToken;
    ...
    /**
     * Register any application services.
     *
     * @return void
     */
    public function boot(Request $request)
    {
        $user = $request->user();

        if ($user) {
            if ($user->sim_asn_token) {
                UserClient::setAccessToken($user->sim_asn_token);
            }

            UserClient::onRefreshToken(function(AccessToken $accessToken) use ($user) {
                $user->sim_asn_token = $accessToken;
                $user->save();
            });
        }
    }

Usage

Create callback handler route

    use SIM_ASN\Laravel\Facades\OauthClient;
    use SIM_ASN\Models\AccessToken;
    use SIM_ASN\Models\User as UserSimASN;

    /**
     * callback sim-asn
     */
    public function callbackSimASN(Request $request)
    {
        return OauthClient::handleCallback($request, function (UserSimASN $userSimASN, AccessToken $token) {
            $user = User::whereSimAsnUserId($userSimASN->id)->first();

            if ($user) {
                $user->sim_asn_token = $token;
                $user->save();
                return Auth::login($user);
            }

            return null;
        });
    }

Manualy get access token by response code

$accessToken = OauthClient::requestAccessToken($request->code);

Get user profile

$user = UserClient::setAccessToken($accessToken)->getUser();

App Client or User Client is extended class from guzzle client so you can directly use http guzzle client

use SIM_ASN\Laravel\Facades\AppClient;
...
AppClient::get('/api/endpoint');
AppClient::post('/api/endpoint', [
    'body' => ['foo' => 'bar']
]);