用 PHP 实现的 MySQL 协议库

Tinywan

发布于 2025-06-08 18:45:24

2900

代码可运行

文章被收录于专栏：开源技术小栈开源技术小栈

运行总次数：0

代码可运行

概述

workbunny/mysql-protocol 是一个用 PHP 实现的 MySQL 协议库，提供了处理 MySQL 协议数据包的功能，可用于开发与 MySQL 服务器交互的客户端、代理或服务器等应用程序。

依赖

PHP >= 8.1
workerman >= 4.0 【可选，workerman环境】

安装

composer require workbunny/mysql-protocol

使用

Binary 二进制流

Binary提供了二进制流和字节组之间的互转能力（注：PHP是二进制安全语言）
Binary提供了基础的字节组读写操作能力，读写操作的指针相互隔离，读写指针默认从0位开始
payload支持传递字符串、字节数组、iterable类型的字节组、null

use Workbunny\MysqlProtocol\Utils\Binary;

$binary = new Binary("workbunny");
# 输出字节组
$binary->unpack();
# 输出字符串(输入明文则返回明文，输入二进制数据则返回二进制)
$binary->pack();
# 输出原始负载
$binary->payload();

读

默认以0位开始，每次操作都会递增相应字节位置

use Workbunny\MysqlProtocol\Utils\Binary;

$binary = new Binary("workbunny");

# 设置读取指针
$binary->setReadCursor();
# 获取读取指针
$binary->getReadCursor();

# 读取一个字节
$binary->readByte();
# 读取多个字节
$binary->readBytes();
# 读取一个整数(长度编码)
$binary->readLenEncInt();
# 读取一个字符串(长度编码)
$binary->readLenEncString();
# 读取一个无符号整数(长度编码)
$binary->readUB();
# 读取一个字符串(以NULL结束)
$binary->readNullTerminated();

写

默认以0位开始，每次操作都会递增相应字节位置

use Workbunny\MysqlProtocol\Utils\Binary;

$binary = new Binary();

# 设置写指针
$binary->setWriteCursor();
# 获取写取指针
$binary->getWriteCursor();

# 写一个字节
$binary->writeByte();
# 写多个字节
$binary->writeBytes();
# 写一个整数(长度编码)
$binary->writeLenEncInt();
# 写一个字符串(长度编码)
$binary->writeLenEncString();
# 写一个无符号整数(长度编码)
$binary->writeUB();
# 写一个字符串(以NULL结束)
$binary->writeNullTerminated();