Consul / PHP

服务发现与配置都在一个客户端

18 个 API 模块与 3 个高层封装，同步调用、Promise 双入口，六种框架共用一套接口。

查看源码版本日志

服务发现、配置中心与集群运维

consul-php 完整覆盖 Consul HTTP API v1，把服务注册发现、配置中心、KV、Session、ACL 与集群运维收进同一套 PHP 客户端。

核心包只依赖 PSR 接口，HTTP 客户端、缓存、日志与事件分发器都可替换；Laravel、Hyperf、webman 等六种框架内置适配并自动发现。

四种健康检查模式
阻塞查询与降级轮询
ACL、Session 与快照

18API 模块

6框架适配

594单元测试

Consu

一只只吃心跳、从不掉线的注册中心小助手：天线是健康检查心跳，胸前脉线代表服务状态，腰间挂着 ACL Token。

心跳还在，服务就不会掉线。

从一次注册到整套服务治理

注册、发现、配置、锁、权限与运维，都经由同一个传输层。

服务注册发现

TTL、HTTP、TCP、gRPC 四种检查，按健康实例做负载均衡。

配置热更新

blocking query 长轮询，异常时降级轮询，恢复后自动切回。

Session 分布式锁

会话创建、续约与销毁，配合 KV acquire 实现资源锁。

ACL 权限体系

Token、Policy、Role 与 AuthMethod 全套管理。

集群运维

Status、Operator、Snapshot 与 Event 等模块齐备。

六框架适配

Laravel、Hyperf、webman、ThinkPHP、Yii2、Yii3 内置适配。

从 API 客户端到服务治理

四次关键发布，把模块、原生支持与框架适配逐一补齐。

v4.1.02026-09-29

Yii2 与 Yii3 适配

补齐 Yii2 应用组件与 Yii3 DI 接入，六框架适配完成。

v4.0.02026-09-25

18 个 API 模块与原生 PHP

深度审计修复，API 模块扩到 18 个，内置 cURL 支持原生 PHP。

v3.3.02026-09-25

内置 cURL 与生命周期助手

新增内置 cURL HTTP 客户端与 NativeService 注册、心跳、注销助手。

v3.2.02026-09-25

多语言图与 artisan 命令

修复多语言图排版，补齐 artisan 命令与本地化资源。

版本日志

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

最新 v4.1.0 全部版本

v4.1.02026-09-29

新增 Yii2 / Yii3 适配，六框架接入完成。

v4.0.22026-09-25

更正 ACL 与 cache.enable 的文档说明。

v4.0.12026-09-25

修复架构图模块 chip 溢出。

v4.0.02026-09-25

深度审计修复，18 个 API 模块与原生 PHP 支持。

v3.3.02026-09-25

内置 cURL 客户端与服务生命周期助手。

v3.2.12026-09-25

项目宠物改为独立宠物图。

架构与设计

点击图片放大查看。

安装与使用

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

PHP 8.0+ / PSR-18完整 README

安装

composer require erikwang2013/consul-php

最小示例

use Erikwang2013\Consul\Client\ConsulClient;

$client = new ConsulClient(['base_uri' => 'http://127.0.0.1:8500']);

$instances = $client->serviceDiscovery()->healthyInstances('user-service');
$dbHost = $client->configCenter()->get('app/db_host', 'localhost');

Consu 的十二种表情

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