composer 是 php 的依赖管理工具，不提供 raft 协议实现；需通过 composer 安装已实现 raft 的第三方库（如 php-raft 或 raft-php），但二者均处于停滞状态且缺乏生产级特性，php 本身运行模型也不适合直接实现 raft。
直接说结论：Composer 是 PHP 的依赖管理工具，它本身不提供 Raft 协议实现，也不具备分布式协同能力；你无法“基于 Composer 库”直接实现 Raft —— 你需要的是一个已实现 Raft 的 PHP 库（如 php-raft 或 raft-php），再用 Composer 安装它。
为什么 Composer 不能“实现”Raft
Composer 只负责下载、自动加载和版本管理。它不包含共识算法逻辑，也不处理网络通信、日志复制或状态机应用。把 Composer 当作“Raft 实现基础”是常见误解——它只是搬运工，不是发动机。
-
composer require下载的是别人写好的 Raft 库，不是 Raft 本身 - 若搜索
composer search raft，返回结果多为包装器、适配器或 demo，真正可用的生产级 PHP Raft 实现极少 - PHP 生态中缺乏像 etcd（Go）、RocksDB（C++）或 JRAFT（Java）那样成熟、压测过的 Raft 实现
当前可用的 PHP Raft 库及其真实状态
截至 2026 年 6 月，能通过 Composer 安装的 Raft 相关库主要有两个：php-raft 和 raft-php，但它们都处于实验或维护停滞状态：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
php-raft：最后一次提交在 2022 年，无快照支持，不处理网络分区下的日志截断，AppendEntries请求未做幂等校验，Follower 崩溃后恢复易丢日志 -
raft-php：依赖reactphp异步 I/O，但未实现RequestVote的 term 检查漏洞修复，选举超时固定为 500ms（违反 Raft 要求的随机化） - 两者均未内置状态机接口，需手动在
apply()回调里写业务逻辑，且不保证调用顺序与日志提交顺序严格一致
如果你真要用 PHP 做 Raft 协同，绕不开的硬约束
PHP 的运行模型决定了它不适合直接承载 Raft 核心流程：
- 单进程 + FPM 模式下，无法长期维持心跳协程，
heartbeatTimer会随请求结束被销毁 - 没有原生原子操作支持，
currentTerm和votedFor的并发读写需靠外部锁（如 Redis），这引入了额外故障点 - 日志存储若用文件系统，
flock()在 NFS 或容器挂载卷上不可靠，容易导致log corruption - PHP 的 GC 和内存模型使
matchIndex/nextIndex数组在高负载下频繁重分配，影响复制延迟稳定性
真正可行的路径是：用 Go 或 Rust 实现 Raft 节点（如基于 etcd/raft），暴露 gRPC/HTTP 接口；PHP 服务只作为客户端调用，专注业务编排。强行在 PHP 里“从零搭 Raft”，最后卡在 electionTimeout 随机性失效或 commitIndex 更新竞争上，调试成本远高于换语言重写。
