php 8.6可以用protoc生成php消息类,再通过google/protobuf运行库序列化和解析二进制消息。先固定.proto字段编号和php命名空间,生成后配置composer自动加载;这条路径适合服务间交换结构化消息,不是直接把json文件改一个扩展名。

官方文档:PHP Generated Code Guide
定义消息和生成目录
安装与消息语法匹配的protoc及google/protobuf运行库,先查看protoc --version。新建proto/order.proto,金额用最小单位整数表达;示例数值保持在普通64位PHP整数范围内。
composer require google/protobuf:"^5.36" mkdir -p proto generated var
syntax = "proto3";
package demo;
option php_namespace = "Demo\Messages";
option php_metadata_namespace = "Demo\Metadata";
message Order {
int64 id = 1;
string sku = 2;
int32 quantity = 3;
int64 amount_fen = 4;
}
官方文档:Language Guide (proto 3)
生成PHP类并加载元数据
执行生成命令,在composer.json已有配置中合并autoload,不覆盖原require。classmap扫描生成目录,可同时发现消息类与元数据类,无需猜测元数据文件名。
protoc -I=proto --php_out=generated proto/order.proto
{"autoload":{"classmap":["generated/"]}}composer dump-autoload composer check-platform-reqs
写入和读回二进制
保存为demo.php并在项目根目录执行。文件放在Web根目录之外;解析前限制大小,避免把任意上传文件不加约束地送入解析器。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
<?php
require __DIR__.'/vendor/autoload.php';
use DemoMessagesOrder;
$order = new Order();
$order->setId(12345)->setSku('SKU-001')->setQuantity(2)->setAmountFen(1990);
$binary = $order->serializeToString();
$file = __DIR__.'/var/order.pb';
if (file_put_contents($file, $binary, LOCK_EX) !== strlen($binary)) {
throw new RuntimeException('Write failed');
}
$input = file_get_contents($file, false, null, 0, 1048577);
if ($input === false || strlen($input)>1048576) throw new RuntimeException('Invalid file');
$decoded = new Order();
$decoded->mergeFromString($input);
echo $decoded->getId(), ' ', $decoded->getSku(), ' ', $decoded->getQuantity(), PHP_EOL;修改协议时保留字段兼容性
接收端应读出12345、SKU-001和2。需要新增字段时使用新的唯一编号;删除字段后用reserved保留旧编号及必要名称,不复用编号改变既有字段含义。proto3标量的默认值也不能自动证明业务字段已填写,仍要校验数量、货号等业务条件。
立即学习“PHP免费学习笔记(深入)”;


















