PHP如何讀寫protobuf3

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檔：

產生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 &#39;vendor/autoload.php&#39;;
include &#39;hello.pb.php&#39;;

$from = new \Lm\helloworld();
$from->setId(1);
$from->setStr(&#39;foo bar, this is a message&#39;);
$from->setOpt(29);

$data = $from->serializeToString();
file_put_contents(&#39;data.bin&#39;, $data);

讀取同樣的二進位檔案：

<?php
include &#39;vendor/autoload.php&#39;;
include &#39;hello.pb.php&#39;;

$data = file_get_contents(&#39;data.bin&#39;);
$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中文網其他相關文章！