mirror of https://github.com/grpc/grpc.git
Stanley Cheung
10 years ago
parent
db7f5226d5
commit
f8401a757c
23 changed files with 525 additions and 103 deletions
@ -0,0 +1,2 @@ |
|||||||
|
composer.lock |
||||||
|
vendor/ |
||||||
@ -0,0 +1,84 @@ |
|||||||
|
gRPC in 3 minutes (PHP) |
||||||
|
=========================== |
||||||
|
|
||||||
|
PREREQUISITES |
||||||
|
------------- |
||||||
|
|
||||||
|
This requires PHP 5.5 or greater. |
||||||
|
|
||||||
|
INSTALL |
||||||
|
------- |
||||||
|
|
||||||
|
- Clone this repository |
||||||
|
|
||||||
|
```sh |
||||||
|
$ git clone https://github.com/grpc/grpc-common.git |
||||||
|
``` |
||||||
|
|
||||||
|
- Install Protobuf-PHP |
||||||
|
|
||||||
|
``` |
||||||
|
$ git clone https://github.com/murgatroid99/Protobuf-PHP.git |
||||||
|
$ cd Protobuf-PHP |
||||||
|
$ rake pear:package version=1.0 |
||||||
|
$ pear install Protobuf-1.0.tgz |
||||||
|
``` |
||||||
|
|
||||||
|
- Install composer |
||||||
|
|
||||||
|
``` |
||||||
|
$ cd grpc-common/php |
||||||
|
$ curl -sS https://getcomposer.org/installer | php |
||||||
|
``` |
||||||
|
|
||||||
|
- (Coming soon) Download the gRPC PECL extension |
||||||
|
|
||||||
|
``` |
||||||
|
Coming soon |
||||||
|
``` |
||||||
|
|
||||||
|
- (Temporary workaround) Compile gRPC extension from source |
||||||
|
|
||||||
|
``` |
||||||
|
$ git clone https://github.com/grpc/grpc.git |
||||||
|
$ cd grpc |
||||||
|
$ git checkout --track origin/release-0_9 |
||||||
|
$ git pull --recurse-submodules && git submodule update --init --recursive |
||||||
|
$ cd third_party/protobuf |
||||||
|
$ ./autogen.sh && ./configure --prefix=/usr && make && make install |
||||||
|
$ cd ../.. |
||||||
|
$ make && make install |
||||||
|
$ cd src/php/ext/grpc |
||||||
|
$ phpize && ./configure && make && make install |
||||||
|
``` |
||||||
|
|
||||||
|
|
||||||
|
TRY IT! |
||||||
|
------- |
||||||
|
|
||||||
|
- Run the server |
||||||
|
|
||||||
|
Please follow the instruction in [Node](https://github.com/grpc/grpc-common/tree/master/node) to run the server |
||||||
|
``` |
||||||
|
$ cd grpc-common/node |
||||||
|
$ nodejs greeter_server.js |
||||||
|
``` |
||||||
|
|
||||||
|
- Run the client |
||||||
|
|
||||||
|
``` |
||||||
|
$ cd grpc-common/php |
||||||
|
$ php composer.phar install |
||||||
|
$ php -d extension=grpc.so greeter_client.php |
||||||
|
``` |
||||||
|
|
||||||
|
NOTE |
||||||
|
---- |
||||||
|
|
||||||
|
This directory has a copy of `helloworld.proto` because it currently depends on |
||||||
|
some Protocol Buffer 2.0 syntax. There is no proto3 support for PHP yet. |
||||||
|
|
||||||
|
TUTORIAL |
||||||
|
-------- |
||||||
|
|
||||||
|
Coming soon |
||||||
@ -0,0 +1,9 @@ |
|||||||
|
{ |
||||||
|
"name": "grpc/grpc-demo", |
||||||
|
"description": "gRPC example for PHP", |
||||||
|
"minimum-stability": "dev", |
||||||
|
"require": { |
||||||
|
"php": ">=5.5.0", |
||||||
|
"grpc/grpc": "dev-master" |
||||||
|
} |
||||||
|
} |
||||||
@ -0,0 +1,51 @@ |
|||||||
|
<?php |
||||||
|
/* |
||||||
|
* |
||||||
|
* Copyright 2015, Google Inc. |
||||||
|
* All rights reserved. |
||||||
|
* |
||||||
|
* Redistribution and use in source and binary forms, with or without |
||||||
|
* modification, are permitted provided that the following conditions are |
||||||
|
* met: |
||||||
|
* |
||||||
|
* * Redistributions of source code must retain the above copyright |
||||||
|
* notice, this list of conditions and the following disclaimer. |
||||||
|
* * Redistributions in binary form must reproduce the above |
||||||
|
* copyright notice, this list of conditions and the following disclaimer |
||||||
|
* in the documentation and/or other materials provided with the |
||||||
|
* distribution. |
||||||
|
* * Neither the name of Google Inc. nor the names of its |
||||||
|
* contributors may be used to endorse or promote products derived from |
||||||
|
* this software without specific prior written permission. |
||||||
|
* |
||||||
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||||
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||||
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||||
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||||
|
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||||
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||||
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||||
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||||
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||||
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||||
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
||||||
|
* |
||||||
|
*/ |
||||||
|
|
||||||
|
require 'DrSlump/Protobuf.php'; |
||||||
|
\DrSlump\Protobuf::autoload(); |
||||||
|
require 'vendor/autoload.php'; |
||||||
|
require 'helloworld.php'; |
||||||
|
|
||||||
|
function greet($name) { |
||||||
|
$client = new helloworld\GreeterClient( |
||||||
|
new Grpc\BaseStub('localhost:50051', [])); |
||||||
|
$request = new helloworld\HelloRequest(); |
||||||
|
$request->setName($name); |
||||||
|
list($reply, $status) = $client->SayHello($request)->wait(); |
||||||
|
$message = $reply->getMessage(); |
||||||
|
return $message; |
||||||
|
} |
||||||
|
|
||||||
|
$name = !empty($argv[1]) ? $argv[1] : 'world'; |
||||||
|
print(greet($name)."\n"); |
||||||
@ -0,0 +1,160 @@ |
|||||||
|
<?php |
||||||
|
// DO NOT EDIT! Generated by Protobuf-PHP protoc plugin 1.0 |
||||||
|
// Source: helloworld.proto |
||||||
|
// Date: 2015-05-29 21:39:19 |
||||||
|
|
||||||
|
namespace helloworld { |
||||||
|
|
||||||
|
class HelloRequest extends \DrSlump\Protobuf\Message { |
||||||
|
|
||||||
|
/** @var string */ |
||||||
|
public $name = null; |
||||||
|
|
||||||
|
|
||||||
|
/** @var \Closure[] */ |
||||||
|
protected static $__extensions = array(); |
||||||
|
|
||||||
|
public static function descriptor() |
||||||
|
{ |
||||||
|
$descriptor = new \DrSlump\Protobuf\Descriptor(__CLASS__, 'helloworld.HelloRequest'); |
||||||
|
|
||||||
|
// OPTIONAL STRING name = 1 |
||||||
|
$f = new \DrSlump\Protobuf\Field(); |
||||||
|
$f->number = 1; |
||||||
|
$f->name = "name"; |
||||||
|
$f->type = \DrSlump\Protobuf::TYPE_STRING; |
||||||
|
$f->rule = \DrSlump\Protobuf::RULE_OPTIONAL; |
||||||
|
$descriptor->addField($f); |
||||||
|
|
||||||
|
foreach (self::$__extensions as $cb) { |
||||||
|
$descriptor->addField($cb(), true); |
||||||
|
} |
||||||
|
|
||||||
|
return $descriptor; |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Check if <name> has a value |
||||||
|
* |
||||||
|
* @return boolean |
||||||
|
*/ |
||||||
|
public function hasName(){ |
||||||
|
return $this->_has(1); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Clear <name> value |
||||||
|
* |
||||||
|
* @return \helloworld\HelloRequest |
||||||
|
*/ |
||||||
|
public function clearName(){ |
||||||
|
return $this->_clear(1); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Get <name> value |
||||||
|
* |
||||||
|
* @return string |
||||||
|
*/ |
||||||
|
public function getName(){ |
||||||
|
return $this->_get(1); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Set <name> value |
||||||
|
* |
||||||
|
* @param string $value |
||||||
|
* @return \helloworld\HelloRequest |
||||||
|
*/ |
||||||
|
public function setName( $value){ |
||||||
|
return $this->_set(1, $value); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
namespace helloworld { |
||||||
|
|
||||||
|
class HelloReply extends \DrSlump\Protobuf\Message { |
||||||
|
|
||||||
|
/** @var string */ |
||||||
|
public $message = null; |
||||||
|
|
||||||
|
|
||||||
|
/** @var \Closure[] */ |
||||||
|
protected static $__extensions = array(); |
||||||
|
|
||||||
|
public static function descriptor() |
||||||
|
{ |
||||||
|
$descriptor = new \DrSlump\Protobuf\Descriptor(__CLASS__, 'helloworld.HelloReply'); |
||||||
|
|
||||||
|
// OPTIONAL STRING message = 1 |
||||||
|
$f = new \DrSlump\Protobuf\Field(); |
||||||
|
$f->number = 1; |
||||||
|
$f->name = "message"; |
||||||
|
$f->type = \DrSlump\Protobuf::TYPE_STRING; |
||||||
|
$f->rule = \DrSlump\Protobuf::RULE_OPTIONAL; |
||||||
|
$descriptor->addField($f); |
||||||
|
|
||||||
|
foreach (self::$__extensions as $cb) { |
||||||
|
$descriptor->addField($cb(), true); |
||||||
|
} |
||||||
|
|
||||||
|
return $descriptor; |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Check if <message> has a value |
||||||
|
* |
||||||
|
* @return boolean |
||||||
|
*/ |
||||||
|
public function hasMessage(){ |
||||||
|
return $this->_has(1); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Clear <message> value |
||||||
|
* |
||||||
|
* @return \helloworld\HelloReply |
||||||
|
*/ |
||||||
|
public function clearMessage(){ |
||||||
|
return $this->_clear(1); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Get <message> value |
||||||
|
* |
||||||
|
* @return string |
||||||
|
*/ |
||||||
|
public function getMessage(){ |
||||||
|
return $this->_get(1); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Set <message> value |
||||||
|
* |
||||||
|
* @param string $value |
||||||
|
* @return \helloworld\HelloReply |
||||||
|
*/ |
||||||
|
public function setMessage( $value){ |
||||||
|
return $this->_set(1, $value); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
namespace helloworld { |
||||||
|
|
||||||
|
class GreeterClient{ |
||||||
|
|
||||||
|
private $rpc_impl; |
||||||
|
|
||||||
|
public function __construct($rpc_impl) { |
||||||
|
$this->rpc_impl = $rpc_impl; |
||||||
|
} |
||||||
|
/** |
||||||
|
* @param helloworld\HelloRequest $input |
||||||
|
*/ |
||||||
|
public function SayHello(\helloworld\HelloRequest $argument, $metadata = array()) { |
||||||
|
return $this->rpc_impl->_simpleRequest('/helloworld.Greeter/SayHello', $argument, '\helloworld\HelloReply::deserialize', $metadata); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
@ -0,0 +1,50 @@ |
|||||||
|
// Copyright 2015, Google Inc. |
||||||
|
// All rights reserved. |
||||||
|
// |
||||||
|
// Redistribution and use in source and binary forms, with or without |
||||||
|
// modification, are permitted provided that the following conditions are |
||||||
|
// met: |
||||||
|
// |
||||||
|
// * Redistributions of source code must retain the above copyright |
||||||
|
// notice, this list of conditions and the following disclaimer. |
||||||
|
// * Redistributions in binary form must reproduce the above |
||||||
|
// copyright notice, this list of conditions and the following disclaimer |
||||||
|
// in the documentation and/or other materials provided with the |
||||||
|
// distribution. |
||||||
|
// * Neither the name of Google Inc. nor the names of its |
||||||
|
// contributors may be used to endorse or promote products derived from |
||||||
|
// this software without specific prior written permission. |
||||||
|
// |
||||||
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||||
|
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||||
|
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||||
|
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||||
|
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||||
|
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||||
|
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||||
|
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||||
|
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||||
|
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||||
|
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
||||||
|
|
||||||
|
syntax = "proto2"; |
||||||
|
|
||||||
|
option java_package = "ex.grpc"; |
||||||
|
|
||||||
|
package helloworld; |
||||||
|
|
||||||
|
// The greeting service definition. |
||||||
|
service Greeter { |
||||||
|
// Sends a greeting |
||||||
|
rpc SayHello (HelloRequest) returns (HelloReply) {} |
||||||
|
} |
||||||
|
|
||||||
|
// The request message containing the user's name. |
||||||
|
message HelloRequest { |
||||||
|
optional string name = 1; |
||||||
|
} |
||||||
|
|
||||||
|
// The response message containing the greetings |
||||||
|
message HelloReply { |
||||||
|
optional string message = 1; |
||||||
|
} |
||||||
Loading…
Reference in new issue