binhtv / grpc-base-laravel
Package help you implement grpc easier
Installs: 11 780
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 1
Forks: 3
Open Issues: 0
Type:php
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
This package is not auto-updated.
Last update: 2024-11-27 21:20:59 UTC
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);