Ganesha 项目教程

Ganesha 项目教程

ganesha :elephant: A Circuit Breaker pattern implementation for PHP applications. 项目地址: https://gitcode.com/gh_mirrors/ga/ganesha

1. 项目介绍

Ganesha 是一个用于 PHP 应用程序的断路器模式实现。断路器模式是一种设计模式，用于防止系统在面对故障时发生级联故障。Ganesha 提供了多种策略来避免级联故障，并支持多种存储方式来记录统计数据。

Ganesha 的主要特点包括：

• 多策略支持：包括基于速率和基于计数的策略。
• 多种存储适配器：支持 Redis、Memcached、APCu 等存储方式。
• 简单易用的接口：提供简单的接口来标识服务、记录成功和失败。
• 事件订阅：支持订阅断路器状态变化的事件。

2. 项目快速启动

安装

首先，确保你已经安装了 PHP 和 Composer。然后，通过 Composer 安装 Ganesha：

# 安装 Composer
$ curl -sS https://getcomposer.org/installer | php

# 使用 Composer 安装 Ganesha
$ php composer.phar require ackintosh/ganesha

使用示例

以下是一个简单的使用示例，展示了如何使用 Ganesha 来防止外部 API 调用失败：

<?php

require 'vendor/autoload.php';

use Ackintosh\Ganesha\Builder;
use Ackintosh\Ganesha\Storage\Adapter\Redis;

// 创建 Redis 适配器
$redis = new \Redis();
$redis->connect('127.0.0.1', 6379);

// 使用速率策略构建 Ganesha 实例
$ganesha = Builder::withRateStrategy()
    ->adapter(new Redis($redis))
    ->failureRateThreshold(50)
    ->intervalToHalfOpen(10)
    ->minimumRequests(10)
    ->timeWindow(30)
    ->build();

$service = 'external_api';

if (!$ganesha->isAvailable($service)) {
    die('外部 API 不可用');
}

try {
    $response = \Api::send($request)->getBody();
    $ganesha->success($service);
    echo $response;
} catch (\Api\RequestTimedOutException $e) {
    $ganesha->failure($service);
    die($e->getMessage());
}

3. 应用案例和最佳实践

应用案例

Ganesha 可以应用于任何需要防止级联故障的场景，特别是在微服务架构中。例如：

• 外部 API 调用：在调用外部 API 时，使用 Ganesha 来防止因外部 API 故障导致的系统崩溃。
• 数据库连接：在数据库连接失败时，使用 Ganesha 来防止数据库故障扩散到整个系统。

最佳实践

• 选择合适的策略：根据具体需求选择基于速率或基于计数的策略。
• 配置合理的阈值：根据系统的负载和容错能力，合理配置失败率阈值和最小请求数。
• 监控和报警：通过订阅事件，实时监控断路器状态变化，并设置报警机制。

4. 典型生态项目

Ganesha 可以与以下项目结合使用，以增强系统的稳定性和可靠性：

• Guzzle：Ganesha 提供了 Guzzle 中间件，可以轻松集成到 Guzzle HTTP 客户端中。
• Symfony HttpClient：Ganesha 支持 Symfony HttpClient，可以在 Symfony 项目中使用。
• OpenAPI Generator：Ganesha 可以与 OpenAPI Generator 生成的客户端代码结合使用，提供更好的容错能力。

通过这些生态项目的结合，Ganesha 可以更好地服务于复杂的分布式系统，提升系统的整体稳定性。

ganesha :elephant: A Circuit Breaker pattern implementation for PHP applications. 项目地址: https://gitcode.com/gh_mirrors/ga/ganesha