PHP需手动实现熔断器，核心是用Redis记录失败次数并设过期时间，失败达阈值（如60秒内5次）则setex标记open状态5分钟，成功时清空计数器与标记，Guzzle可通过中间件集成此逻辑。
PHP 本身没有内置熔断器（Circuit Breaker），调用远程服务超时后不会自动熔断；必须手动实现状态跟踪 + 超时判定 + 熔断拦截逻辑。
超时发生时如何触发熔断判断
不能只靠 curl_setopt($ch, CURLOPT_TIMEOUT) 或 stream_context_set_option(..., 'timeout') 单纯设超时——那只是中断单次请求，不记录失败历史。真正熔断需满足两个条件：连续失败次数达标 + 最近 N 次失败率超阈值（如 5 次里失败 4 次）。
- 每次请求无论成功/失败/超时，都写入一个共享存储（如 Redis 的
list或zset），保留最近 10 条时间戳+结果 - 发起新请求前，先查该服务的失败窗口：用
LRANGE service:api:failures 0 -1拿最近记录，过滤出 60 秒内的失败数 - 若失败率 ≥ 80% 且失败数 ≥ 3，则跳过真实调用，直接返回
["error" => "circuit_open"]
PHP 中用 Redis 实现熔断状态管理
推荐用 Redis 的 SET + 过期时间存熔断开关，比轮询历史更轻量。例如：
// 检查是否已熔断
if ($redis->get('circuit:api_v2') === 'open') {
throw new Exception('Service is in open state');
}
// 请求失败后尝试熔断
$failCount = $redis->incr('circuit:api_v2:failcount');
$redis->expire('circuit:api_v2:failcount', 60); // 60秒窗口
if ($failCount >= 5) {
$redis->setex('circuit:api_v2', 300, 'open'); // 熔断5分钟
}
-
setex设置带过期的熔断标记，避免永久不可用 - 成功响应后必须重置计数器：
$redis->del('circuit:api_v2:failcount')和$redis->del('circuit:api_v2') - 注意 Redis 命令原子性：
INCR+EXPIRE非原子，建议用 Lua 脚本封装
使用 Guzzle 时怎么注入熔断逻辑
Guzzle 7+ 支持中间件（Middleware），可在发送前检查熔断状态、在异常后更新状态，比在每个 request() 外套 if 更干净。
立即学习“PHP免费学习笔记（深入）”；
- 注册一个
circuit_breaker中间件，在on_stats事件里捕获超时（$stats->hasError()且$stats->getTransferTime() > 3.0） - 超时或 5xx 响应时调用
recordFailure($serviceKey)，成功时调用recordSuccess($serviceKey) - 中间件前置逻辑里调用
isCircuitOpen($serviceKey)，返回 true 就抛GuzzleException避免发包 - 别依赖
connect_timeout和timeout的默认值——显式设为3.0和5.0，否则熔断阈值难对齐
熔断不是加个超时就完事；关键是失败可感知、状态可持久、恢复有机制。Redis 键名设计、重置时机、半开状态（half-open）是否实现，才是实际落地时最容易漏掉的点。
