@ -3,7 +3,7 @@
This directory contains source code for PHP implementation of gRPC layered on
shared C library. The same installation guides with more examples and
tutorials can be seen at [grpc.io ](https://grpc.io/docs/quickstart/php.html ).
tutorials can be seen at [grpc.io ](https://grpc.io/docs/languages/php/ quickstart ).
gRPC PHP installation instructions for Google Cloud Platform is in
[cloud.google.com ](https://cloud.google.com/php/grpc ).
@ -36,7 +36,7 @@ or specific version
$ [sudo] pecl install grpc-1.25.0
```
Note: for users on CentOS/RHEL 6, unfortunately this step won’t work.
Note: for users on CentOS/RHEL 6, unfortunately this step won’t work.
Please follow the instructions below to compile the PECL extension from source.
@ -74,8 +74,8 @@ $ make
$ [sudo] make install
```
This will compile and install the `grpc` extension into the
standard PHP extension directory. You should be able to run
This will compile and install the `grpc` extension into the
standard PHP extension directory. You should be able to run
the [unit tests ](#unit-tests ), with the `grpc` extension installed.
@ -100,7 +100,7 @@ composer package as well. Add this to your project's `composer.json` file.
}
```
To run tests with generated stub code from `.proto` files, you will also
To run tests with generated stub code from `.proto` files, you will also
need the `composer` and `protoc` binaries. You can find out how to get these
below.
@ -120,7 +120,7 @@ classes.
If you don't have it already, you need to install the protobuf compiler
`protoc` , version 3.5.0+ (the newer the better) for the current gRPC version.
If you installed already, make the protobuf version is compatible to the
If you installed already, make the protobuf version is compatible to the
grpc version you installed. If you build grpc.so from the souce, you can check
the version of grpc inside package.xml file.
@ -128,15 +128,15 @@ The compatibility between the grpc and protobuf version is listed as table
below:
grpc | protobuf
--- | ---
--- | ---
v1.0.0 | 3.0.0(GA)
v1.0.1 | 3.0.2
v1.1.0 | 3.1.0
v1.2.0 | 3.2.0
v1.2.0 | 3.2.0
v1.3.4 | 3.3.0
v1.1.0 | 3.1.0
v1.2.0 | 3.2.0
v1.2.0 | 3.2.0
v1.3.4 | 3.3.0
v1.3.5 | 3.2.0
v1.4.0 | 3.3.0
v1.4.0 | 3.3.0
v1.6.0 | 3.4.0
v1.8.0 | 3.5.0
v1.12.0 | 3.5.2
@ -197,7 +197,7 @@ version you build this plugin.
### `protobuf` runtime library
There are two `protobuf` runtime libraries to choose from. They are identical
in terms of APIs offered. The C implementation provides better performance,
in terms of APIs offered. The C implementation provides better performance,
while the native implementation is easier to install.
#### C implementation (for better performance)
@ -365,11 +365,11 @@ $client = new Helloworld\GreeterClient('localhost:50051', [
]);
```
### Compression
### Compression
You can customize the compression behavior on the client side, by specifying the following options when constructing your PHP client.
```
```
Possible values for grpc.default_compression_algorithm:
0 - No compression
1 - Compress with DEFLATE algorithm
@ -387,7 +387,7 @@ Here's an example on how you can put them all together:
```
$client = new Helloworld\GreeterClient('localhost:50051', [
'credentials' => Grpc\ChannelCredentials::createInsecure(),
'grpc.default_compression_algorithm' => 2,
'grpc.default_compression_algorithm' => 2,
'grpc.default_compression_level' => 2,
]);