README

PHP的Protobuf是Google的Protocol Buffers在PHP语言中的实现，支持其二进制数据序列化，并包括一个protoc插件，用于从.proto文件生成PHP类。

安装

如果您想将.proto定义编译成PHP，您需要从您喜欢的包管理器或从源代码中安装Google的Protocol Buffers。此插件目前支持protobuf 2.3.0或更高版本。

注意: Google的Protocol Buffers和proto不是protobuf-php/protobuf的运行时要求，它仅当您想使用protobuf-php/protobuf-plugin将定义编译成PHP时才是必要的。

安装Google的Protocol Buffers

• OSX安装

$ brew install protobuf

• Ubuntu

$ sudo apt-get install -y protobuf

确保用户路径中有protoc

$ protoc --version
$ # libprotoc 2.6.1

注意: 有关如何安装/编译Google的Protocol Buffers的更多信息，请参阅：https://github.com/google/protobuf

Composer安装

要安装PHP插件，请运行以下composer命令

$ composer require "protobuf-php/protobuf-plugin"

定义您的协议格式

要创建您的地址簿应用程序，您需要从.proto文件开始。在.proto文件中的定义很简单：您为每个要序列化的数据结构添加一个消息，然后指定消息中每个字段的名称和类型。以下是定义您的消息的.proto文件，addressbook.proto。

package tutorial;
import "php.proto";
option (php.package) = "Tutorial.AddressBookProtos";

message Person {
  required string name = 1;
  required int32 id = 2;
  optional string email = 3;

  enum PhoneType {
    MOBILE = 0;
    HOME = 1;
    WORK = 2;
  }

  message PhoneNumber {
    required string number = 1;
    optional PhoneType type = 2 [default = HOME];
  }

  repeated PhoneNumber phone = 4;
}

message AddressBook {
  repeated Person person = 1;
}

如您所见，语法类似于C++或Java。让我们来看看文件中的每一部分及其作用。.proto文件以包声明开始，这有助于防止不同项目之间的命名冲突。在PHP中，包名用作PHP命名空间，除非您显式指定了(php.package)，如我们在这里所做的那样。即使您提供了(php.package)，您仍然应该定义一个正常的包，以避免在Protocol Buffers命名空间以及非PHP语言中的名称冲突。

您可以在Protocol Buffer语言指南中找到编写.proto文件的完整指南，包括所有可能的字段类型。不过，不要寻找类似于类继承的设施——协议缓冲区不支持这一点。

编译您的Protocol Buffers

现在您有了.proto文件，下一步您需要生成您需要的类来读取和写入AddressBook（以及Person和PhoneNumber）消息。为此，您需要运行协议缓冲区插件在您的.proto上。

在这种情况下

php ./vendor/bin/protobuf --include-descriptors -i . -o ./src/ ./addressbook.proto

这将生成以下PHP类在指定的目标目录中

src/
└── Tutorial
    └── AddressBookProtos
        ├── AddressBook.php
        ├── Person
        │   ├── PhoneNumber.php
        │   └── PhoneType.php
        └── Person.php

注意: 有关如何使用生成的代码的更多信息，请参阅：protobuf-php/protobuf