PHPackages                             tourze/symfony-circuit-breaker-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. tourze/symfony-circuit-breaker-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

tourze/symfony-circuit-breaker-bundle
=====================================

为 Symfony 应用提供分布式熔断器功能，支持故障隔离和服务降级

0.0.1(6mo ago)00MITPHPCI passing

Since Nov 11Pushed 4mo ago1 watchersCompare

[ Source](https://github.com/tourze/symfony-circuit-breaker-bundle)[ Packagist](https://packagist.org/packages/tourze/symfony-circuit-breaker-bundle)[ RSS](/packages/tourze-symfony-circuit-breaker-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (35)Versions (2)Used By (0)

Symfony Circuit Breaker Bundle
==============================

[](#symfony-circuit-breaker-bundle)

[English](README.md) | [中文](README.zh-CN.md)

[![Latest Version](https://camo.githubusercontent.com/9e03f925c1b9e2e14d6c3b1d34f015b0e14f46d2bff2971a24174244da689d0a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f746f75727a652f73796d666f6e792d636972637569742d627265616b65722d62756e646c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tourze/symfony-circuit-breaker-bundle)[![PHP Version Require](https://camo.githubusercontent.com/a301a2f3a798ccd7dbc5f89085bfa6910ff2504b190976afa33f412edbaf8e79/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f746f75727a652f73796d666f6e792d636972637569742d627265616b65722d62756e646c653f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tourze/symfony-circuit-breaker-bundle)

[![License](https://camo.githubusercontent.com/ac4da2e3a8f7a4444d9b4d4c9cefc814c307ec0ddcdbb70d68dc8c460a7f8fc9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f746f75727a652f73796d666f6e792d636972637569742d627265616b65722d62756e646c653f7374796c653d666c61742d737175617265)](LICENSE)[![Build Status](https://camo.githubusercontent.com/08b06d999f4c30f1e949cfd5d5b620251b8744710f075e38dcb384330112e7f6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f746f75727a652f73796d666f6e792d636972637569742d627265616b65722d62756e646c652f43493f7374796c653d666c61742d737175617265)](https://github.com/tourze/php-monorepo/actions)[![Coverage Status](https://camo.githubusercontent.com/6ce0146325478eb7cebae4cc6139b2af2c161735dd0e3c6ff6802f2c5a708179/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f746f75727a652f7068702d6d6f6e6f7265706f3f7374796c653d666c61742d737175617265)](https://codecov.io/gh/tourze/php-monorepo)

Symfony熔断器Bundle，为Symfony应用提供高性能、可扩展的熔断器功能， 支持单机和集群环境，帮助您构建更健壮的微服务应用。

Table of Contents
-----------------

[](#table-of-contents)

- [功能特性](#%E5%8A%9F%E8%83%BD%E7%89%B9%E6%80%A7)
- [安装](#%E5%AE%89%E8%A3%85)
- [快速开始](#%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B)
    - [使用注解（Attribute）方式](#%E4%BD%BF%E7%94%A8%E6%B3%A8%E8%A7%A3attribute%E6%96%B9%E5%BC%8F)
    - [直接使用服务](#%E7%9B%B4%E6%8E%A5%E4%BD%BF%E7%94%A8%E6%9C%8D%E5%8A%A1)
    - [使用带熔断功能的HTTP客户端](#%E4%BD%BF%E7%94%A8%E5%B8%A6%E7%86%94%E6%96%AD%E5%8A%9F%E8%83%BD%E7%9A%84http%E5%AE%A2%E6%88%B7%E7%AB%AF)
- [Configuration](#configuration)
    - [Environment Variable Configuration](#environment-variable-configuration)
    - [Configuration Parameters](#configuration-parameters)
- [Dependencies](#dependencies)
    - [Required Dependencies](#required-dependencies)
    - [Optional Dependencies](#optional-dependencies)
    - [Storage Backends](#storage-backends)
- [命令行工具](#%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7)
- [高级用法](#%E9%AB%98%E7%BA%A7%E7%94%A8%E6%B3%95)
    - [手动管理熔断状态](#%E6%89%8B%E5%8A%A8%E7%AE%A1%E7%90%86%E7%86%94%E6%96%AD%E7%8A%B6%E6%80%81)
    - [自定义HTTP客户端降级处理](#%E8%87%AA%E5%AE%9A%E4%B9%89http%E5%AE%A2%E6%88%B7%E7%AB%AF%E9%99%8D%E7%BA%A7%E5%A4%84%E7%90%86)
- [贡献指南](#%E8%B4%A1%E7%8C%AE%E6%8C%87%E5%8D%97)
- [参考资料](#%E5%8F%82%E8%80%83%E8%B5%84%E6%96%99)
- [许可证](#%E8%AE%B8%E5%8F%AF%E8%AF%81)

功能特性
----

[](#功能特性)

- **高性能存储**：使用Redis原子操作，支持滑动窗口统计
- **多层故障转移**：Redis → Doctrine → Memory，确保熔断器始终可用
- **多种熔断策略**：失败率策略、慢调用策略、连续失败策略
- **集群支持**：基于共享存储的状态同步，支持分布式部署
- **监控接口**：提供JSON格式的REST API查看熔断器状态
- **灵活配置**：纯环境变量配置，支持全局和特定熔断器配置
- **命令行工具**：查看状态、重置、强制开关等操作

安装
--

[](#安装)

通过Composer安装：

```
composer require tourze/symfony-circuit-breaker-bundle
```

在Symfony项目中注册Bundle：

```
// config/bundles.php
return [
    // ...
    Tourze\Symfony\CircuitBreaker\CircuitBreakerBundle::class => ['all' => true],
];
```

快速开始
----

[](#快速开始)

### 使用注解（Attribute）方式

[](#使用注解attribute方式)

在控制器方法上使用熔断器注解：

```