mirror of https://github.com/grpc/grpc.git
The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
https://grpc.io/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
87 lines
1.6 KiB
87 lines
1.6 KiB
5 years ago
|
|
||
|
|
# gRPC PHP End-to-End Examples
|
||
|
|
|
||
|
|
This page shows a number of ways to create a PHP gRPC client and connect with
|
||
|
|
a gRPC backend service.
|
||
|
|
|
||
|
|
|
||
|
|
## Run the Server
|
||
|
|
|
||
|
|
For all the following examples, we use a simple gRPC server, written in Node.
|
||
|
|
|
||
|
|
```sh
|
||
|
|
$ git clone https://github.com/grpc/grpc-web
|
||
|
|
$ cd grpc-web
|
||
|
|
$ docker-compose build common node-server
|
||
|
|
$ docker run -d -p 9090:9090 --name node-server grpcweb/node-server
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Install the gRPC PECL extension
|
||
|
|
|
||
|
|
All the following commands are assumed to be run from this current directory.
|
||
|
|
|
||
|
|
```sh
|
||
|
|
$ cd grpc/examples/php/echo
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
In order to build a PHP gRPC client, we need to install the `grpc` extension
|
||
|
|
first.
|
||
|
|
|
||
|
|
```sh
|
||
|
|
$ docker build -t grpc-php/base -f ./base.Dockerfile .
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## CLI
|
||
|
|
|
||
|
|
|
||
|
|
Let's first build a simple CLI gRPC client:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
$ docker build -t grpc-php/echo-client -f ./cli.Dockerfile .
|
||
|
|
$ docker run -it --rm --link node-server:node-server grpc-php/echo-client
|
||
|
|
$ php client.php
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Apache
|
||
|
|
|
||
|
|
|
||
|
|
Now let's see how the gRPC PHP client can run with Apache:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
$ docker build -t grpc-php/apache -f ./apache.Dockerfile .
|
||
|
|
$ docker run -it --rm --link node-server:node-server -p 80:80 grpc-php/apache
|
||
|
|
```
|
||
|
|
|
||
|
|
Open the browser to `http://localhost`.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Nginx + FPM
|
||
|
|
|
||
|
|
|
||
|
|
We can also try running PHP-FPM and put Nginx in front of it.
|
||
|
|
|
||
|
|
|
||
|
|
The PHP-FPM part:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
$ docker build -t grpc-php/fpm -f ./fpm.Dockerfile .
|
||
|
|
$ docker run -it --rm --link node-server:node-server -p 9000:9000 \
|
||
|
|
--name fpm grpc-php/fpm
|
||
|
|
```
|
||
|
|
|
||
|
|
The Nginx part:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
$ docker run -it --rm -v $(pwd)/nginx.conf:/etc/nginx/conf.d/default.conf:ro \
|
||
|
|
--link fpm:fpm -p 80:80 nginx:1.17.4
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
Open the browser to `http://localhost`.
|