protobuf(Google Protocol Buffers)是Google提供一個具有高效的協議資料交換格式工具庫(類似Json),但相比於Json,Protobuf有更高的轉換效率,時間效率和空間效率都是JSON的3-5倍。
在proto3中,可以直接使用protoc指令產生PHP程式碼。產生的PHP程式碼不能直接使用,還需要Protobuf的PHP函式庫支援。
下面透過一個範例示範下PHP怎麼使用protobuf。先定義proto檔:
syntax = "proto3"; package lm; message helloworld { int32 id = 1; // ID string str = 2; // str int32 opt = 3; // optional field }
注意這裡採用的是proto3的語法,和proto2不太一樣,required和optional的限定已經沒有了,所有的欄位都是可選的。 proto3比起proto2有什麼差別,可以參考 這篇文章。
接著用protoc產生PHP檔:
protoc --php_out=./ hello.proto
會看到產生了一個hello.pb.php檔:
namespace Lm; use Google\Protobuf\Internal\DescriptorPool; use Google\Protobuf\Internal\GPBType; use Google\Protobuf\Internal\RepeatedField; use Google\Protobuf\Internal\GPBUtil; class helloworld extends \Google\Protobuf\Internal\Message { .... }
閱讀下裡面的程式碼,發現它use了Google\Protobuf下的類,這是一個PHP函式庫,可以去下載:
https://github.com/google/protobuf/tree/master/php/ src/Google/Protobuf
也可以用composer引入到專案中,推薦用composer引入,因為composer會幫你自動產生Autoloader:
composer require google/protobuf
採用composer方式引入google/protobuf之後,項目中會出現一個vendor目錄。在自己的程式碼中includevendor下的autoload.php,以及剛才產生的helloworld.pb.php文件,就可以進行二進位的讀寫了。
有了google/protobuf函式庫的幫助,PHP讀寫protobuf格式的二進位還是很方便的。
利用protobuf寫入資料到二進位檔案:
<?php include 'vendor/autoload.php'; include 'hello.pb.php'; $from = new \Lm\helloworld(); $from->setId(1); $from->setStr('foo bar, this is a message'); $from->setOpt(29); $data = $from->serializeToString(); file_put_contents('data.bin', $data);
讀取同樣的二進位檔案:
<?php include 'vendor/autoload.php'; include 'hello.pb.php'; $data = file_get_contents('data.bin'); $to = new \Lm\helloworld(); $to->mergeFromString($data); echo $to->getId() . PHP_EOL; echo $to->getStr() . PHP_EOL; echo $to->getOpt() . PHP_EOL;
推薦學習:php影片教學
以上是PHP如何讀寫protobuf3的詳細內容。更多資訊請關注PHP中文網其他相關文章!