This will compile and install the gRPC PHP extension into the standard PHP extension directory. You should be able to run the [unit tests](#unit-tests), with the PHP extension installed.
To run tests with generated stub code from `.proto` files, you will need the `composer`, `protoc` and `protoc-gen-php` binaries additionally. See sections[below](#generated-code-tests).
To run tests with generated stub code from `.proto` files, you will also need the `composer`, `protoc` and `protoc-gen-php` binaries. You can find out how to get these[below](#generated-code-tests).
## Build from Source
...
...
@@ -115,9 +115,11 @@ $ ./bin/run_tests.sh
## Generated Code Tests
This section specifies the prerequisites for running the generated code tests, as well as how to run the tests themselves.
### Composer
You need to install `composer`, to pull in some runtime dependencies based on the `composer.json` file.
If you don't have it already, install `composer` to pull in some runtime dependencies based on the `composer.json` file.
You need the install the protobuf compiler,`protoc`, 3.0.0+.
Again if you don't have it already, you need to install the protobuf compiler `protoc`, version 3.0.0+.
If you had compiled the gRPC C core library from source above, the `protoc` binary should have been installed as well. In the case it wasn't, you can run the following commands to install it.
If you compiled the gRPC C core library from source above, the `protoc` binary should have been installed as well. If it hasn't been installed, you can run the following commands to install it.
```sh
$ cd grpc/third_party/protobuf
$ sudo make install# 'make' should have been run by core grpc
```
Or you can download a `protoc` binaries from [here](https://github.com/google/protobuf/releases).
Alternatively, you can download `protoc` binaries from [the protocol buffers Github repository](https://github.com/google/protobuf/releases).
### PHP protobuf compiler
You need to install `protoc-gen-php`, so that you can generate stub classes`.php` files from service definition `.proto` files.
You need to install `protoc-gen-php` to generate stub class `.php` files from service definition `.proto` files.
```sh
$ cd grpc/src/php/vendor/datto/protobuf-php # if you had run `composer install` in the previous step
...
...
@@ -168,7 +170,7 @@ $ ./bin/generate_proto_php.sh
### Run test server
Run a local server serving the math services. Please see [Node][]on how to run an example server
Run a local server serving the math services. Please see [Node][]for how to run an example server.