binhtv/grpc-base-laravel

Package help you implement grpc easier

v1.0.6 2022-07-27 09:31 UTC

Requires

• php: ^7.4
• google/common-protos: ^2.0.0
• google/protobuf: ^3.19
• grpc/grpc: ^1.42
• spiral/php-grpc: ^1.6
• spiral/roadrunner-laravel: ^3.7

MIT

• Binh

README

About package

This is a product of programmer sun*.

This package has some class and method help yan can implement Grpc to Laravel easier. So improve system performance thanks to Grpc

How to use

composer require binhtv/grpc-base-laravel

then run command to publish config.

php artisan vendor:publish --tag=binhtv-grpc-config

You need know how to compile files proto with php

Client

• Autoload file proto generated:

"autoload": {
        "psr-4": {
        ...
            "": "protos/generated/"
        },
        ...
    },

• Quick call to server (recommend using)
  
  step 1: create class extend BaseGrpcApi;

<?php

namespace App\Services\MicroserviceGrpc;

use binhtv\GrpcLaravel\Client\Contracts\BaseGrpcApi;
use Google\Protobuf\Internal\Message;
use Illuminate\Http\Request;
use Protobuf\Company\ExampleServiceClient;

/**
 * @method Message ExampleMethod(array|Request $request)
 */

class ExampleGrpcClient extends BaseGrpcApi
{
    public function grpcClient(): string
    {
        return ExampleServiceClient::class;
    }
}

step 2: call method in that class;

<?php
 ...
// ExampleMethod is a method of ExampleServiceClient;
 (new ExampleGrpcClient())->ExampleMethod($request);
 ...

• Or create new client Grpc

$clientGrpc = (new GrpcFactory)->make(ExampleServiceClient::class);

• Use traits;

 ...
 use binhtv\GrpcLaravel\Client\Traits\HandleDataRequest;
 ...
 class ExampleController extends Controller
 {
    use HandleDataRequest;
 }

• methods:

Serve

• Start serve:

./vendor/binhtv/grpc-base-laravel/rr-grpc serve -v -d

• Example worker file:

<?php

declare(strict_types=1);

use App\Grpc\ExampleGrpcController;
use Spiral\Goridge\StreamRelay;
use Spiral\RoadRunner\Worker;

ini_set('display_errors', 'stderr');

require __DIR__.'/vendor/autoload.php';

$app = require_once __DIR__.'/bootstrap/app.php';

$app->singleton(
    binhtv\GrpcLaravel\Server\Contracts\Kernel::class,
    binhtv\GrpcLaravel\Server\Kernel::class
);

$app->singleton(
    binhtv\GrpcLaravel\Server\Contracts\ServiceInvoker::class,
    binhtv\GrpcLaravel\Server\LaravelServiceInvoker::class
);

$kernel = $app->make(binhtv\GrpcLaravel\Server\Kernel::class);

$kernel->registerService(ExampleGrpcController::class);

$w = new Worker(new StreamRelay(STDIN, STDOUT));

$kernel->serve($w);