Download the PHP package larrythecoder/grpc without Composer

On this page you can find all versions of the php package larrythecoder/grpc. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of larrythecoder/grpc

Informations about the package grpc

PHP-gRPC library

Unofficial work of PHP gRPC implementation for asynchronous calls. The implementation is taken from @arnaud-lb php-async branch.

Here lies the documentation to interact with my own grpc binding library.

Asynchronous calls

PHP does not have an event-loop. Thus, user-space event loop is required to check if a call is completed. The following must be called periodically as a scheduled task. The first parameter in this method is the time allowed for the polling mechanism to time-out, setting it to PHP_INT_MIN will cause it to immediately process any events and return immediately no more than O(1).

The completion queue will check if any calls is complete once.

Client gRPC calls

Currently, we support all types of user call. Thanks to the new asynchronous implementation, Bidirectional streaming is now possible over PHP without blocking the current executing thread (if the RPC is using asynchronous methods). The table below shows the supported service method via asynchronous or synchronous operations.

Service Method Asynchronous Synchronous
Unary RPC Supported Supported
Server Streaming RPC Supported Supported
Client Streaming RPC Supported Supported
Bidirectional RPC Supported Supported

All service method in PHP now requires a Callback to handle messages received from the server. The callback method may return an object if documented, usually the object returned are messages that was consumed from the server and/or a RpcCallStatus that contains information about the RPC after completed.

Each AbstractCall will now have an interface indicating that the call itself is either ClientCallInterface and/or a ServerCallInterface, the implementing methods have similar implementation but a clear and concise documentation can be referred in the interface itself.

Interface Unary Server Streaming Client Streaming Bidirectional
ServerCallInterface Yes Yes No Yes
ClientCallInterface No No Yes Yes

Unary Call

Unary call is the basic foundation of the HTTP protocol, a client send out a request, and they will expect an answer returned from the server. The code below is how the preferred way on how to start a Unary Call.

Server Streaming Call

For asynchronous operation, it is not required to start another onStreamNext call. The logic is such that the previous callback will be reused to consume the next message received.

However, for synchronous operation. it is required to start another onStreamNext call after receiving a message from the server. In other word, the previous callback will not be reused to consume the next message. The behaviour for this method is different from an asynchronous operations because of how synchronous operations work.

Since the working thread will be blocked, having onStreamNext to handle multiple messages from the server will prevent other tasks from running. PHP is mostly consists of a single-thread that executes tasks, the option to wait for message to be consumed from the server is very limited.

Therefore, developers will have to properly implement on how messages will be consumed to all ServerCallInterface based on their requirements.

Client Streaming Call

A client streaming call is a service method that send messages to the server and the server will return a single response for us to consume/read. For both asynchronous and synchronous operations, below snippet can be used.

Bidirectional Streaming Call

A bidirectional streaming call is a combination of Client streaming method and Server streaming method, it typically used for long-lived streaming and/or processes that takes multiple input and output from client and the server. Either way, it depends on the use-cases and how you want it to be implemented.

All versions of grpc with dependencies

PHP Build Version
Package Version
Requires php Version >=7.1
sof3/await-generator Version ^3.6
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package larrythecoder/grpc contains the following files

Loading the files please wait ....