Utilisation du format de données ProtoBuf dans un environnement PHP

Avant-propos

RPC est un Google entreprise Un framework RPC leader qui utilise protobuf comme format de transmission de données Avec la maturité du framework gRPC et l'augmentation du nombre d'utilisateurs, protobuf, le format de données sous-jacent utilisé, a également reçu de plus en plus d'attention pour l'écosystème PHP. , le ProtoBuf associé Il existe relativement peu de documents d'introduction et d'informations d'utilisation, j'espère donc écrire un bref article pour aider certains étudiants dans le besoin.

ProtoBuf (Google Protocol Buffer) est un format de données structuré en séquence utilisé par Google pour l'échange de données. Il possède des fonctionnalités multiplateformes, multilingues et évolutives. utilisé XML et JSON, mais il a un volume de transmission plus petit et des capacités d'encodage et de décodage plus élevées. Il est particulièrement adapté aux domaines tels que le stockage de données et la transmission de données réseau qui nécessitent un volume de stockage élevé et des performances en temps réel.

  La dernière version officielle de ProtoBuf, ProtoBuf3, prend déjà en charge plusieurs langages : C++C#GoJavaPythonRubyObject C JavascriptPHP, et fournit des outils pour générer facilement les bibliothèques de classes requises par ProtoBuf selon différents langages.

  Ce qui suit utilisera le format de données Personne comme exemple pour décrire comment utiliser ProtoBuf3 dans un environnement PHP.

1. Définir un type de message

Créer un fichier de définition sur Personne (avec .proto comme suffixe), comme dans le exemple est person.proto, le contenu du fichier est le suivant :

syntax="proto3";
package test;
message Person{
 string name=1;//姓名
 int32 age=2;//年龄
 bool sex=3;//性别
}

1 syntax="proto3" : indique que le format proto3 est utilisé, s'il n'est pas spécifié, il. sera proto2

2. Package test : Définissez le nom du package comme test Lors de la génération d'une classe, un répertoire sera généré comme test

3. Contenu du corps du message, qui contient la définition de chaque champ

2. Générez la classe PHP correspondante

Après avoir défini le format. de Personne, si le format ne génère pas ce dont nous avons besoin, les bibliothèques de classes n'ont en réalité aucun sens. Google fournit également un protocole d'outil pour générer les bibliothèques de classes que nous souhaitons.

1. Protocole d'installation

Adresse d'installation : protobuf-php-3.5.1.tar.gz, la dernière en date est 3.5.1

Officiel Adresse de sortie : https://github.com/google/protobuf/releases/tag/v3.5.1

Décompressez et installez :

tar -zxvf protobuf-php-3.5.1.tar.gz
cd protobuf-3.5.1
./configure --prefix=/opt/soft/protobuf
make
make install

2. Générer une bibliothèque de classes

/opt/soft/protobuf/bin/protoc --php_out=./ person.proto

Après la génération, les fichiers suivants seront générés dans le répertoire actuel :

GPBMetadata/Person.php

Test/Person.php

3. Utilisation de ProtoBuf en PHP

L'utilisation de ProtoBuf en PHP repose sur une extension protobuf. Il existe actuellement deux façons de l'utiliser, 1 : l'extension c de php, 2 : le package d'extension lib de php, les deux. Il peut être trouvé dans le package de téléchargement dès maintenant.

De plus, vous pouvez également utiliser composer pour installer l'extension dépendante : composer require google/protobuf

Ici j'utilise principalement composer pour l'installer, ce qui devrait m'aider générer un chargement automatique

Après avoir installé les dépendances, nous pouvons commencer à utiliser protobuf dans l'environnement php

Sérialisation

<?php
include &#39;vendor/autoload.php&#39;;
include &#39;GPBMetadata/Person.php&#39;;
include &#39;Test/Person.php&#39;;

$person = new Test\Person();
$person->setName("lailaiji");
$person->setAge("28");
$person->setSex(true);
$data = $person->serializeToString();
file_put_contents(&#39;data.bin&#39;,$data);

2. La désérialisation

<?php
include &#39;vendor/autoload.php&#39;;
include &#39;GPBMetadata/Person.php&#39;;
include &#39;Test/Person.php&#39;;
$bindata = file_get_contents(&#39;./data.bin&#39;);
$person = new Test\Person();
$person->mergeFromString($bindata);
echo $person->getName();

peut générer lailaiji normalement

Utilisation courante de PHP :

Sérialisation :

1. SerializeToString : sérialiser en une chaîne binaire

2. SerializeToJsonString : sérialiser en une chaîne JSON

Désérialisation :

1. mergeFromString : désérialisation de chaîne binaire

2. mergeFromJsonString : désérialisation de chaîne Json

.Analyse du message Proto

1. Définition :

Tapez le nom de la variable = position

Par exemple : int32 age=1;

Il faut le distinguer ici. Le nombre après le nom de la variable signifie la position du contenu de la variable dans la séquence binaire plutôt que la valeur de la variable. Le nombre doit être non réutilisable.

2. Types actuellement pris en charge :

double, float, int32, int64, uint32, uint64, sint32, sint64

fixed32 , fixed64,sfixed32,sfixed64,bool,bytes

Tutoriel recommandé : "PHP"

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!