Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hetao29/php-grpc-server-protobuf
The php gRPC server framework with php-fpm and nginx.
https://github.com/hetao29/php-grpc-server-protobuf
framework grpc nginx php php-fpm protobuf
Last synced: about 2 months ago
JSON representation
The php gRPC server framework with php-fpm and nginx.
- Host: GitHub
- URL: https://github.com/hetao29/php-grpc-server-protobuf
- Owner: hetao29
- License: mit
- Created: 2022-01-02T03:49:47.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-24T04:04:39.000Z (9 months ago)
- Last Synced: 2024-04-25T05:08:03.764Z (9 months ago)
- Topics: framework, grpc, nginx, php, php-fpm, protobuf
- Language: PHP
- Homepage:
- Size: 7.18 MB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# php-grpc-server-protobuf
The php grpc server framework with protobuf and DO NOT use any 3rd libraries or use Swoole.
Support protobuf and json request.
# Architecture
## mode with nginx & php-fpm (only support php client and http json request)
1. gRPC Client => nginx => php-fpm => this framework => custom services => protobuf binary response
2. http/https json request (content-type:application/json) => nginx => php-fpm => this framework => custom services => json response
## mode with swoole (all gRPC Client and http json request)
1. gRPC Client => Swoole => this framework => custom services => protobuf binary response
2. http/https json request (content-type:application/json) => Swoole => this framework => custom services => json response
# Usage
1. install with composer
```bash
composer require "hetao29/php-grpc-server-protobuf:dev-main"
```
2. use in php file, like samples/www/index.php (php-fpm mode)
```php
on('request', function (Swoole\Http\Request $request, Swoole\Http\Response $response) use ($http) {
$content_type = (isset($request->header['content-type']) && $request->header['content-type']=='application/json') ? 'json' : null; //json | null (default)
if($content_type=="json"){
$response->header('content-type', 'application/json');
}else{
$response->header('content-type', 'application/grpc');
}
try{
if(($r=GRpcServer::run($request->server['request_uri'], $request->rawContent(), $content_type))!==false){
//echo($r);
$response->header('trailer', 'grpc-status, grpc-message');
$trailer = [
"grpc-status" => "0",
"grpc-message" => ""
];
foreach ($trailer as $trailer_name => $trailer_value) {
$response->trailer($trailer_name, $trailer_value);
}
$response->end($r);
}
}catch(Exception $e){
$response->header('trailer', 'grpc-status, grpc-message');
$trailer = [
"grpc-status" => $e->getCode(),
"grpc-message" => $e->getMessage(),
];
foreach ($trailer as $trailer_name => $trailer_value) {
$response->trailer($trailer_name, $trailer_value);
}
$response->end();
}
});
$http->start();
```
# Write App Services
1. proto and genproto to php files
```bash
cd proto && make
```
2. write gRPC Server in services dir like helloworld
```php
setMessage("Hello2, ".$request->getName()."!");
return $reply;
}
}
```
3. config nginx && php-fpm
```conf
server {
listen 50010 http2; #with http2 is grpc protocol
#listen 50010; #without http2 is json protocol
root /data/server/;
location / {
if (!-e $request_filename){
rewrite ^/(.+?)$ /index.php last;
}
}
location ~ \.php$ {
fastcgi_param REMOTE_ADDR $http_x_real_ip;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
```
4. test
```bash
# cli mode
php client/hello.php
# curl command (json request)
# swoole (50000 port)
curl -d '{"name":"xx"}' -v http://127.0.0.1:50000//Test.Helloworld.Greeter/SayHello -H "content-type:application/json"
# nginx php-fpm (50010 port)
curl -d '{"name":"xx"}' -v http://127.0.0.1:50010//Test.Helloworld.Greeter/SayHello -H "content-type:application/json"
# or web browser
```