游乐游手机版
首页/编程语言/文章详情

PHP Protobuf扩展安装指南与使用方法详解

时间:2026-05-08 08:11
安装allegro php-protobuf扩展需在源码目录执行phpize、 configure、make和makeinstall命令,并在php ini中添加extension=protobuf so。定义 proto文件后,使用项目脚本生成PHP类。应用时,可解析JAVA端传来的二进制数据,或构造并序列化数据发送,通过对应类的方法实现数据操作。

所用资源

本教程实践基于GitHub上开源的高效序列化工具:allegro/php-protobuf。该项目为PHP语言提供了完整的Protocol Buffers支持。

prodected php,安装php的php-protobu扩展及使用

安装PHP的protobuf扩展

安装PHP的protobuf扩展步骤非常标准,与安装其他PHP扩展流程基本一致。首先进入解压后的扩展源码目录,然后按顺序执行以下命令:

phpize

./configure

make

make install

编译安装完成后,最关键的一步是在你的php.ini配置文件中添加一行扩展声明:

extension=protobuf.so

请务必记得重启你的PHP服务(例如PHP-FPM或Apache)。之后,通过创建一个phpinfo()页面进行验证,就能看到protobuf扩展已经成功加载并启用了。

如何使用?

第一步:定义与生成

首先,你需要创建一个.proto文件来定义你的数据结构格式。例如,我们创建一个名为foo.proto的文件,其内容如下:

message PhoneNumber {
required string number = 1;
required int32 type = 2;
}

message Person {
required string name = 1;
required int32 id = 2;
optional string email = 3;
repeated PhoneNumber phone = 4;
}

message AddressBook {
repeated Person person = 1;
}

数据结构定义完成后,使用allegro/php-protobuf项目提供的PHP脚本生成对应的PHP类文件:

php protoc-php.php foo.proto

执行成功后,你将得到一个名为pb_proto_foo.php的PHP文件。该文件包含了根据proto定义自动生成的PHP类,后续所有的序列化与反序列化操作都将依赖这些类。

第二步:应用实践

接下来我们通过具体场景来学习如何使用。假设我们需要与一个Java后端服务进行基于Protobuf的数据通信。

场景一:解析Java端传来的Buffer数据

当Java服务返回了一个经过序列化的protobuf二进制数据流时,在PHP端可以按以下方式解析:

require_once 'pb_proto_test.php'; // 引入之前生成的PHP类文件
$packed = curlGet('https://10.0.247.113:8080/testweb/proto'); // 此处模拟从Java端获取的二进制数据
$foo = new AddressBook();
try {
$foo->parseFromString($packed); // 核心解析方法,将二进制流反序列化为对象
} catch (Exception $ex) {
die('Parse error: ' . $e->getMessage()); // 解析出错时的异常处理
}
$pb = $foo->getPerson(); // 获取Person对象列表
// 可以打印整个数组查看结构:print_r($pb);
// 或者仅打印第一个元素:print_r($pb[0]);
// 在实际业务中,直接访问对象的Getter方法即可:
echo $pb[0]->getName() .' _ '.$pb[0]->getId() .' _ ';
print_r($pb[0]->getPhone());

场景二:PHP生成并修改Buffer数据

反之,PHP端也可以构造数据对象,将其序列化为二进制Buffer后发送给其他服务:

require_once 'pb_proto_test.php';
$foo = new Person();
$foo->setName('xiaojh');
$foo->setId(200);
$foo->setEmail('dofound@163.com');
// 如果需要添加重复字段(例如phone),可以使用append方法://$foo->appendPhone(2);
$packed = $foo->serializeToString(); // 核心序列化方法,得到二进制Buffer
$foo->clear(); // 清空对象状态,以便重复使用
try {
$xiao = $foo->parseFromString($packed); // 可将序列化后的数据再次解析回来,用于验证
// print_r($xiao);
} catch (Exception $ex) {
die('Upss.. there is a bug in this example');
}
echo $foo->getName();
echo $foo->getPhone()->number;
$foo->dump(); // 部分生成类会提供dump方法,便于调试时查看对象内容

PHP内部调用

------------------------------
生成buffer数据

来源:https://blog.csdn.net/weixin_39957805/article/details/116003120
上一篇Laravel框架序列化优化与查询结果精简方法教程 下一篇PHP如何安装与启用FFmpeg扩展详细教程
本站内容用于信息整理与展示,如有侵权或内容问题请及时联系处理。

相关推荐

补充同频道和同主题内容,方便继续浏览更多相关内容。

同类最新

继续查看同栏目最近更新的文章。

更多
CentOS与Golang打包常见兼容性问题探讨
编程语言 · 2026-07-01

CentOS与Golang打包常见兼容性问题探讨

CentOS与Golang打包的兼容性问题集中在glibc版本不匹配、交叉编译环境变量错误、依赖库缺失及Go依赖管理不规范。可通过Docker容器编译、选择兼容Go版本、正确设置GOOS GOARCH环境变量、安装对应开发包及使用GoModules解决。

CentOS中Fortran与Python如何协同工作从入门到实战完整教程
编程语言 · 2026-07-01

CentOS中Fortran与Python如何协同工作从入门到实战完整教程

在CentOS中,Fortran与Python可通过f2py、SWIG、共享库调用或subprocess协同。f2py封装Fortran为Python模块,支持数组运算;共享库需手动对齐数据类型;系统调用适合独立计算。

CentOS中Golang打包优化方法
编程语言 · 2026-07-01

CentOS中Golang打包优化方法

在CentOS中优化Golang编译打包,可显著提升编译速度并减小二进制文件体积。关键技巧包括:设置环境变量、使用Go模块管理依赖、编译时添加-ldflags= "-s-w "去除调试信息、利用UPX工具压缩、运行strip清理符号表,以及优化cgo内C代码的编译选项。综合运用这些方法能有效优化最终程序。

在CentOS系统中cpustat与其他工具协同使用的完整方法
编程语言 · 2026-07-01

在CentOS系统中cpustat与其他工具协同使用的完整方法

cpustat作为sysstat包的CPU监控工具,可通过管道与grep等命令配合过滤数据,利用脚本自动记录带时间戳的日志,或结合图形工具查看,也可格式化输出后接入Zabbix、Grafana等Web监控系统,实现可视化与告警。

CentOS中readdir与其他Linux发行版的差异
编程语言 · 2026-07-01

CentOS中readdir与其他Linux发行版的差异

CentOS基于RHEL,与Ubuntu、Debian、Fedora在包管理器(yum dnfvsapt)、默认文件系统(XFSvsext4)等存在差异,但readdir等系统调用遵循POSIX标准,行为一致。