はじめに
RPC は Google ですデータ転送形式として protobuf を使用する主要な RPC フレームワークです。gRPC フレームワークの成熟とユーザー数の増加に伴い、使用される基礎的なデータ形式である protobuf もますます注目を集めています。PHP エコシステムの場合、関連する ProtoBuf の紹介ドキュメントや使用方法の情報が比較的少ないため、困っている学生に役立つことを願って簡単な記事を書きます。
ProtoBuf (Google Protocol Buffer) は、Google がデータ交換に使用するシーケンス構造化データ形式です。クロスプラットフォーム、クロス言語、スケーラブルな特性を持ち、一般的なものと同じタイプです。 XMLやJSONを利用していましたが、伝送量が少なく、エンコード・デコード能力が高く、特にデータストレージやネットワークデータ伝送など、大容量かつリアルタイム性が要求される分野に適しています。
公式 ProtoBuf の最新バージョンである ProtoBuf3 は、すでに複数の言語 C \C#\Go\Java\Python\Ruby\Object C \Javascript\PHP をサポートしており、簡単に適応できるツールを提供しています。さまざまな言語 ProtoBuf に必要なクラス ライブラリを生成します。
以下では、例として Person データ形式を使用して、PHP 環境で ProtoBuf3 を使用する方法を説明します。
1. メッセージ タイプを定義します。
次のように、Person に関する定義ファイル (拡張子として .proto が付きます) を作成します。例は person.proto です。ファイルの内容は次のとおりです:
syntax="proto3"; package test; message Person{ string name=1;//姓名 int32 age=2;//年龄 bool sex=3;//性别 }
1、syntax="proto3": proto3 形式が使用されることを示します。指定されていない場合は、proto3 形式が使用されることを示します。 is proto2
2. パッケージテスト: パッケージ名をtestと定義します. クラス生成時にtest
3というディレクトリが生成されます. メッセージ担当者: メッセージ本文の内容 (各フィールドの定義が含まれます)
2. 対応する PHP クラスを生成します
#形式を定義した後形式が必要なものを生成しない場合、クラス ライブラリは実際には意味がありません。Google は、必要なクラス ライブラリを生成するためのツール プロトコルも提供しています。
1. protoc をインストールします
インストール アドレス: protobuf-php-3.5.1.tar.gz、最新は 3.5.1
officialリリースアドレス: 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#3. ProtoBuf の使用PHP での
<?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);
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();
PHP を使用する一般的な方法:
#2.serializeToJsonString: JSON 文字列にシリアル化します
逆シリアル化:
1、mergeFromString: バイナリ文字列の逆シリアル化
2、mergeFromJsonString: Json 文字列の逆シリアル化
.
Proto のメッセージ分析
#1. 定義:
型変数名 = 位置;
例: int32 age=1;
推奨チュートリアル: "
"
以上がPHP 環境での ProtoBuf データ形式の使用の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。