PHPackages                             friendsofhyperf/jet - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. friendsofhyperf/jet

ActiveLibrary[HTTP & Networking](/categories/http)

friendsofhyperf/jet
===================

Another jet client for Hyperf

v4.4.0(1w ago)53.4k↑258.9%2MITPHPPHP >=8.1CI passing

Since Jul 15Pushed 1w agoCompare

[ Source](https://github.com/friendsofhyperf/jet)[ Packagist](https://packagist.org/packages/friendsofhyperf/jet)[ Fund](https://hdj.me/sponsors/)[ GitHub Sponsors](https://github.com/huangdijia)[ RSS](/packages/friendsofhyperf-jet/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (18)Versions (69)Used By (0)

Jet
===

[](#jet)

[![Latest Test](https://github.com/friendsofhyperf/jet/workflows/tests/badge.svg)](https://github.com/friendsofhyperf/jet/actions)[![Latest Stable Version](https://camo.githubusercontent.com/ca69b6d2705912d8b220fef419062da02b4f1b36ffef4bce528229e73de6d466/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f667269656e64736f666879706572662f6a6574)](https://packagist.org/packages/friendsofhyperf/jet)[![Total Downloads](https://camo.githubusercontent.com/178d704209a08c1d99c58e3c1a5a0b5deafdf88732392d761d48645660ef21f8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f667269656e64736f666879706572662f6a6574)](https://packagist.org/packages/friendsofhyperf/jet)[![GitHub license](https://camo.githubusercontent.com/3969d5ddd534c7972e7b57a9286a49144ac7ba283039c528bec21a67542d60dc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f667269656e64736f666879706572662f6a6574)](https://github.com/friendsofhyperf/jet)

Another jet client for Hyperf

Installation
------------

[](#installation)

### Composer

[](#composer)

```
composer require "friendsofhyperf/jet:^4.0"
```

QuickStart
----------

[](#quickstart)

### Register with metadata

[](#register-with-metadata)

```
use FriendsOfHyperf\Jet\Metadata;
use FriendsOfHyperf\Jet\ServiceManager;
use FriendsOfHyperf\Jet\Registry\ConsulRegistry;
use FriendsOfHyperf\Jet\Transporter\GuzzleHttpTransporter;

$metadata = (new Metadata('CalculatorService'))
    ->withTransporter(new GuzzleHttpTransporter('127.0.0.1', 9502))
    // or
    ->setRegistry(new ConsulRegistry(['uri' => 'http://127.0.0.1:8500']))
    ;

ServiceManager::register('CalculatorService', $metadata);
```

### Register default registry

[](#register-default-registry)

```
use FriendsOfHyperf\Jet\RegistryManager;
use FriendsOfHyperf\Jet\Registry\ConsulRegistry;

RegistryManager::register(RegistryManager::DEFAULT, new ConsulRegistry(['uri' => $uri, 'timeout' => 1]));
```

> In Laravel project, Add to `boot()` in `App/Providers/AppServiceProvider.php`

Call RPC method
---------------

[](#call-rpc-method)

### Call by ClientFactory

[](#call-by-clientfactory)

```
use FriendsOfHyperf\Jet\ClientFactory;

$client = ClientFactory::create('CalculatorService');
var_dump($client->add(1, 20));
```

### Call by ClientFactory Using Grpc

[](#call-by-clientfactory-using-grpc)

```
use FriendsOfHyperf\Jet\ClientFactory;

return ClientFactory::create(function() {
    return (new Metadata('CalculatorService'))
        ->withPacker(new GrpcPacker())
        ->withPathGenerator(new GrpcPathGenerator())
        // If use consul next config is necessary
        ->withRegistry(RegistryManager::get(RegistryManager::DEFAULT))
        ->withTransporterConfig([
            'path' => 'calculator.CalCulator',
        ])
        ->withProtocol('grpc')
        ->withTimeout(10)
        // If not use consul,directly use GrpcTransporter
        ->withTransporter(new GrpcTransporter('127.0.0.1', 9502, [
            'path' => 'calculator.CalCulator',
        ]));
});
```

### Call by custom client

[](#call-by-custom-client)

```
use FriendsOfHyperf\Jet\Client;
use FriendsOfHyperf\Jet\Transporter\GuzzleHttpTransporter;
use FriendsOfHyperf\Jet\Registry\ConsulRegistry;

/**
 * @method int add(int $a, int $b)
 */
class CalculatorService extends Client
{
    public function __construct($service = 'CalculatorService')
    {
        $metadata = (new Metadata($service))
            // Custom transporter
            ->withTransporter(new GuzzleHttpTransporter('127.0.0.1', 9502))
            // Custom registry
            ->withRegistry(new ConsulRegistry(['uri' => 'http://127.0.0.1:8500']));

        parent::__construct($metadata);
    }
}

$service = new CalculatorService;
var_dump($service->add(3, 10));
```

### Call by custom facade

[](#call-by-custom-facade)

```
use FriendsOfHyperf\Jet\Facade;
use FriendsOfHyperf\Jet\ClientFactory;

/**
 * @method static int add(int $a, int $b)
 */
class Calculator extends Facade
{
    protected static function getFacadeAccessor()
    {
        // return ClientFactory::create('CalculatorService');
        return 'CalculatorService';
    }
}

var_dump(Calculator::add(rand(0, 100), rand(0, 100)));
```

Coroutine support in Hyperf
---------------------------

[](#coroutine-support-in-hyperf)

- Aspect

```