README

使用 Buzz HTTP 客户端的 Etcd v3 PHP 客户端。

特性

• ✨ 完整支持 Etcd v3 API
• 🔄 服务注册与发现（含心跳）
• 📡 服务调用（负载均衡）
• 🔐 用户认证与权限管理
• 📦 租约管理
• 🎯 PHP 8.2+ 语法兼容

环境要求

安装

composer require chenbool/etcd-buzz-client

快速开始

<?php
require 'vendor/autoload.php';

use chenbool\Etcd\Client;

// 创建客户端
$client = new Client('127.0.0.1:2379');

1. KV 操作

// 写入
$client->put('key', 'value');

// 读取
$value = $client->get('key');

// 删除
$client->del('key');

2. 服务注册

// 单个注册
$client->registerService('user-svc', '192.168.1.10', 8080, 30, ['version' => '1.0']);

// 批量注册
$client->registerServices([
    ['name' => 'order-svc', 'host' => '192.168.1.20', 'port' => 8080],
    ['name' => 'order-svc', 'host' => '192.168.1.21', 'port' => 8080],
]);

3. 服务调用

// GET 请求
$response = $client->call('user-svc', 'GET', '/api/user/1');

// POST 请求
$response = $client->call('user-svc', 'POST', '/api/user', ['name' => 'tom']);

// 轮询负载均衡
$response = $client->call('user-svc', 'GET', '/api/users', [], 'round');

4. 服务发现

// 发现指定服务
$services = $client->discoverService('user-svc');

// 获取所有服务
$allServices = $client->getAllServices();

// 发现所有服务（按服务名分组）
$grouped = $client->discoverAll('/services/');
// 返回: ['user-svc' => [...], 'order-svc' => [...]]

// 健康检查
$health = $client->getServiceHealth('user-svc', '192.168.1.10', 8080);

5. 租约管理

// 刷新单个租约
$client->refreshServiceLease('user-svc', '192.168.1.10', 8080, 60);

// 批量刷新
$client->refreshServiceLeases([
    ['name' => 'user-svc', 'host' => '192.168.1.10', 'port' => 8080],
]);

// 刷新所有服务租约
$client->refreshAllServicesLease(60);

// 心跳（单服务，阻塞运行）
// $client->heartbeat('user-svc', '192.168.1.10', 8080, 10);

// 批量心跳（多服务，阻塞运行）
$services = [
    ['name' => 'user-svc', 'host' => '192.168.1.10', 'port' => 8080],
    ['name' => 'order-svc', 'host' => '192.168.1.20', 'port' => 8080],
];
$client->heartbeatAll($services, 30, 25, function($name, $host, $port) {
    echo "[Heartbeat] {$name}\n";
});

6. 注销服务

$client->deregisterService('user-svc', '192.168.1.10', 8080);

API 文档

KV 操作

租约 Lease

认证 Auth

服务注册与发现

服务调用

许可证

MIT