gitkv/laravel-gearman-rpc

Laravel/Lumen Gearman rpc. Based from https://github.com/mhlavac/gearman

Laravel Gearman rpc

, _(*1)

Laraval / Lumen Gearman Remote Procedure Call, _(*2)

Requires: * Laravel / Lumen >=5.5 * PHP >= 7.1 * Gearman PHP extension * Socket PHP extension, _(*3)

Installation

• Run:

composer require "gitkv/laravel-gearman-rpc"

• Install gearman job server as PHP-extension: http://gearman.org/getting-started/#gearman_php_extension
  
• Install supervisor:

apt-get install supervisor

Configuration

Laravel:

Add service provider to /config/app.php:, _(*4)

'providers' => [
    gitkv\GearmanRpc\GearmanRpcServiceProvider::class
],
'aliases' => [
    'GearmanRpc' => gitkv\GearmanRpc\Facade\GearmanRpc::class,
],

Publish config/gearman-rpc.php, _(*5)

php artisan vendor:publish --provider="gitkv\GearmanRpc\GearmanRpcServiceProvider" --tag=config

Usage

Worker:

Create handler:

Create a file in the directory app\Rpc\MyRpcHandler.php, _(*6)

<?php

namespace App\Rpc;


use gitkv\GearmanRpc\HandlerContract;

class MyRpcHandler implements HandlerContract {

    public function handle($payload) {
        return [
            'status'  => 'success',
            'payload' => $payload,
        ];
    }

}

Add your handler to the handlers section in the config/gearman-rpc.php file, _(*7)

'MyExampleFunction' => \App\Rpc\MyRpcHandler::class,

Configure supervisor

Example supervisor config, _(*8)

[program:app-rpc-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/app/artisan gearman-rpc
autostart=true
autorestart=true
user = www
numprocs=1
redirect_stderr=true
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

Client:

Synch call, _(*9)

<?php
$result = GearmanRpc::doNormal('MyExampleFunction', json_encode(['test'=>'data']));

Asynch call, _(*10)

<?php
GearmanRpc::doBackground('MyExampleFunction', json_encode(['test'=>'data']));