前言
??RPC是google公司主導(dǎo)的一款RPC框架猾昆,并使用protobuf作為數(shù)據(jù)傳輸格式,伴隨gRPC框架的成熟及使用人群的增加鬼悠,對于底層使用的數(shù)據(jù)格式protobuf也被越來越受到重視三椿,而對于PHP生態(tài)而言,相關(guān)ProtoBuf介紹文檔及使用資料比較少薇溃,故此寫簡文希望能幫助到一些有需要的同學(xué)。
??ProtoBuf (Google Protocol Buffer)是由google公司用于數(shù)據(jù)交換的序列結(jié)構(gòu)化數(shù)據(jù)格式缭乘,具有跨平臺沐序、跨語言、可擴展特性,類型于常用的XML及JSON策幼,但具有更小的傳輸體積邑时、更高的編碼、解碼能力特姐,特別適合于數(shù)據(jù)存儲晶丘、網(wǎng)絡(luò)數(shù)據(jù)傳輸?shù)葘Υ鎯w積、實時性要求高的領(lǐng)域唐含。
??目前官方ProtoBuf 最新版本ProtoBuf3浅浮,已經(jīng)支持多種語言:C++\C#\Go\Java\Python\Ruby\Object C \Javascript\PHP,并且提供工具很方便地根據(jù)不同語言產(chǎn)生ProtoBuf需要的類庫捷枯。
??下面將通過Person數(shù)據(jù)格式作為示例進行描述如果在PHP環(huán)境中如何使用ProtoBuf3滚秩。
一、定義一個消息類型
創(chuàng)建一個關(guān)于Person的定義文件(以.proto為后綴)铜靶,如示例為person.proto叔遂,文件內(nèi)容如下:
syntax="proto3";
package test;
message Person{
string name=1;//姓名
int32 age=2;//年齡
bool sex=3;//性別
}
1、syntax="proto3":表明使用的是proto3格式争剿,如果不指定則為proto2
2已艰、package test:定義包名為test,生成類時蚕苇,會產(chǎn)生一個目錄為test
3哩掺、message Person:消息主體內(nèi)容,里面為各個字段的定義
二涩笤、生成對應(yīng)的PHP類
定義好Person的格式后嚼吞,該格式如果不生成我們所需要的類庫,其實是無任何意義的蹬碧,還google提供一個工具protoc生成我們要的類庫舱禽。
1、安裝protoc
安裝地址:protobuf-php-3.5.1.tar.gz,目前最新為3.5.1
官方發(fā)布地址:https://github.com/google/protobuf/releases/tag/v3.5.1
解壓并安裝:
tar -zxvf protobuf-php-3.5.1.tar.gz
cd protobuf-3.5.1
./configure --prefix=/opt/soft/protobuf
make
make install
2恩沽、生成類庫
/opt/soft/protobuf/bin/protoc --php_out=./ person.proto
生成后將在當(dāng)前目錄產(chǎn)生如下文件:
GPBMetadata/Person.php
Test/Person.php
三誊稚、在PHP中使用ProtoBuf
在PHP中使用ProtoBuf依賴一個protobuf的擴展,目前提供兩種方式進行使用,1:php的c擴展罗心,2:php的lib擴展包里伯,這兩者均可在剛才下載包里可以找到。
另外渤闷,也可以使用composer進行安裝該依賴擴展:composer require google/protobuf
這里我主要是使用composer安裝疾瓮,應(yīng)該它可以幫我產(chǎn)生autoload
安裝好依賴后,我們就可以開始在php環(huán)境下使用protobuf了
1飒箭、序列化
<?php
include 'vendor/autoload.php';
include 'GPBMetadata/Person.php';
include 'Test/Person.php';
$person = new Test\Person();
$person->setName("lailaiji");
$person->setAge("28");
$person->setSex(true);
$data = $person->serializeToString();
file_put_contents('data.bin',$data);
運行后狼电,產(chǎn)生的data.bin,只有14Byte
2蜒灰、反序列化
<?php
include 'vendor/autoload.php';
include 'GPBMetadata/Person.php';
include 'Test/Person.php';
$bindata = file_get_contents('./data.bin');
$person = new Test\Person();
$person->mergeFromString($bindata);
echo $person->getName();
可以正常地輸出lailaiji
PHP常用的使用方法:
序列化:
1、serializeToString:序列化成二進制字符串
2肩碟、serializeToJsonString:序列化成JSON字符串
反序列化:
1卷员、mergeFromString:二進制字符串反序列化
2、mergeFromJsonString:Json字符串反序列化
.proto的message解析
1腾务、定義:
類型 變量名=位置;
如:int32 age=1;
這里需要區(qū)分,變量名后面的數(shù)字意義為該變量內(nèi)容在二進制序列中的位置而不是變量的值削饵,該數(shù)字必須是唯一不可重復(fù)使用岩瘦。
2、目前支持的類型:
double,float,int32,int64,uint32 ,uint64,sint32,sint64
fixed32,fixed64,sfixed32,sfixed64,bool,bytes
性能測試
https://github.com/eishay/jvm-serializers/wiki
1窿撬、序列號+反序列號時間:
2启昧、存儲大小: