PHP / etcd v3

把 etcd 装进PHP 的进程里

八大 API 域、HTTP 与 gRPC 双传输,六种框架开箱接入。

Etchy 小象,etcd 的项目宠物

客户端覆盖 etcd v3 全部 API

EtcdClient 提供 KV、Watch、Lease、Auth、Cluster、Maintenance、Election 与 Lock 八个子系统的访问器。

HTTP 通道自动选择 curl、PHP 流封装或 PSR-18;Laravel、Hyperf、ThinkPHP、Webman、Yii2、Yii3 安装即用。

  • 八大 API 域
  • HTTP 与 gRPC
  • 六种框架适配
8API 域
6框架适配
v1.5.0当前版本
Etchy 小象 的 微笑 表情

Etchy

一只蓝色小象,头顶三节点 Raft 集群,鼻尖挂着 k/v 与 rev 标签,代表 PHP etcd v3 客户端。

掉线自己重连,过期自己清理。

八个子系统各司其职

每个子系统只做一件事,异常分层清晰。

KV 与事务

单键、前缀、范围查询,原子 CAS 事务与嵌套事务,compact 释放历史版本。

Watch 监听

单键或前缀监听,自动续订 lastRevision + 1,WatchHandle 可随时取消。

Lease 租约

grant、keepAlive、timeToLive、revoke,过期自动清理。

Auth 认证

用户、角色与权限管理,凭据自动换 token,401 自动重新认证。

集群与运维

成员增删与 Learner 提升,status、defrag、快照流式落盘并校验 sha256。

选举与锁

Election 竞选与 leader 观察,Lock 基于租约实现,SIGKILL 后自动释放。

一次发布补上一块能力

从传输回退到框架适配,每一步都有真实提交。

v1.5.0

Yii2 与 Yii3 适配

新增两套 Yii 适配器,Laravel、Hyperf、ThinkPHP、Webman、Yii2、Yii3 六框架齐备。

v1.4.0

选举、锁与 gRPC

新增 Election、Lock、snapshotTo 与 watch 取消;gRPC 一元 RPC 落地。

v1.3.0

对真实集群修缺陷

修复 watch 不可用、无参方法 400、keepAlive 必抛等问题,重建测试防线。

v1.2.0

无扩展也能跑

HTTP 传输增加原生 PHP 流封装回退,没有 ext-curl 与 PSR-18 也可用。

版本日志

最近的发布记录,完整列表在 GitHub Releases。

最新 v1.5.0 全部版本
v1.5.02026-09-29

新增 Yii2 与 Yii3 适配,架构图适配层扩到六格。

v1.4.12026-09-26

文档同步八大 API 域、Election/Lock 卡片与真集群验证章节。

v1.4.02026-09-26

新增 Election、Lock、snapshotTo 与 watch 取消;gRPC 一元 RPC 落地。

v1.3.02026-09-25

修复对真实 etcd 不可用的一批缺陷,重建测试防线。

v1.2.02026-09-25

HTTP 传输增加原生 PHP 回退,无 ext-curl 与 PSR-18 也能跑。

v1.1.02026-09-25

确立发布策略:公开 API 进 minor,并补发 v1.1.0。

安装与使用

先安装,再跑一个最小示例。

PHP >= 8.1完整 README
安装
composer require erikwang2013/etcd
最小示例
use Erikwang2013\Etcd\EtcdClient;

$etcd = new EtcdClient(['endpoints' => ['127.0.0.1:2379']]);

$etcd->kv()->put('/app/config', '{"debug":true}');
$result = $etcd->kv()->get('/app/config');
print_r($result['kvs'][0]);

Etchy 的十二种表情

鼠标停一停,它会换一种心情。

搜索本站

输入关键词,例如“上传”“迁移”“JWT”。