prodected php,安装php的php-protobu扩展及使用

所用资源

本次实践基于GitHub上的开源项目：allegro/php-protobuf。

安装PHP的protobuf扩展

过程其实很标准，和安装其他PHP扩展类似。进入解压后的源码目录，依次执行以下命令：

phpize

./configure

make

make install

安装完成后，关键一步是在你的php.ini配置文件中添加一行：

extension=protobuf.so

别忘了重启你的PHP服务（比如FPM或Apache）。之后，在phpinfo()页面里，就能看到protobuf扩展已经成功加载了。

如何使用？

第一步：定义与生成

首先，得有个.proto文件来定义你的数据结构。比如，我们创建一个foo.proto文件，内容如下：

message PhoneNumber {
required string number = 1;
required int32 type = 2;
}

message Person {
required string name = 1;
required int32 id = 2;
optional string email = 3;
repeated PhoneNumber phone = 4;
}

message AddressBook {
repeated Person person = 1;
}

定义好了之后，使用项目提供的PHP脚本生成对应的PHP类文件：

php protoc-php.php foo.proto

执行成功，你会得到一个名为pb_proto_foo.php的文件，里面包含了根据proto定义生成的PHP类，后续操作就靠它了。

第二步：应用实践

接下来看看具体怎么用。假设我们需要与一个JA VA服务进行通信。

场景一：解析JA VA端传来的Buffer数据

JA VA服务返回了一个序列化后的protobuf数据流，在PHP端可以这样解析：

require_once 'pb_proto_test.php'; // 引入刚才生成的类文件
$packed = curlGet('http://10.0.247.113:8080/testweb/proto'); // 这里模拟从JA VA端获取的二进制数据
$foo = new AddressBook();
try {
$foo->parseFromString($packed); // 核心解析方法
} catch (Exception $ex) {
die('Parse error: ' . $e->getMessage()); // 解析出错的处理
}
$pb = $foo->getPerson(); // 获取Person列表
// 可以打印整个数组看看：print_r($pb);
// 或者打印第一个：print_r($pb[0]);
// 实际使用中，直接访问对象属性即可：
echo $pb[0]->getName() .' _ '.$pb[0]->getId() .' _ ';
print_r($pb[0]->getPhone());

场景二：PHP生成并修改Buffer数据

反过来，PHP也可以构造数据并序列化后发送出去：

require_once 'pb_proto_test.php';
$foo = new Person();
$foo->setName('xiaojh');
$foo->setId(200);
$foo->setEmail('dofound@163.com');
// 如果需要添加重复字段（如phone），可以使用append方法：//$foo->appendPhone(2);
$packed = $foo->serializeToString(); // 核心序列化方法，得到二进制Buffer
$foo->clear(); // 清空对象，准备重新使用
try {
$xiao = $foo->parseFromString($packed); // 可以将序列化的数据再解析回来验证
// print_r($xiao);
} catch (Exception $ex) {
die('Upss.. there is a bug in this example');
}
echo $foo->getName();
echo $foo->getPhone()->number;
$foo->dump(); // 有些生成类会提供dump方法方便调试

PHP内部调用

------------------------------
生成buffer数据