PHP download

Download the PHP package cmatosbc/alecto without Composer

On this page you can find all versions of the php package cmatosbc/alecto. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download cmatosbc/alecto
More information about cmatosbc/alecto
Files in cmatosbc/alecto

Vendor cmatosbc
Package alecto
Short Description A robust PHP Circuit Breaker implementation with type safety and modern features
License MIT

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of cmatosbc/alecto

Informations about the package alecto

Alecto - PHP Circuit Breaker Library

A robust PHP implementation of the Circuit Breaker pattern with type safety, metrics tracking, and configurable behavior.

In the depths of Greek mythology, Alecto, one of the three Erinyes or Furies, emerges as a formidable figure. These divine beings were born from the blood of the castrated Uranus, embodying the relentless pursuit of vengeance. Alecto, in particular, is known for her unwavering determination and relentless pursuit of justice.

Her story offers a powerful metaphor for a circuit breaker pattern in programming. Just as Alecto intervenes to stop a cycle of violence and retribution, a circuit breaker interrupts a process to prevent it from spiraling out of control. In the realm of software, this might mean stopping an infinite loop, halting a runaway process, or preventing a system from crashing.

By drawing inspiration from Alecto, we can design circuit breaker patterns that are:

Swift and decisive: Like the Erinyes, a circuit breaker must act quickly to prevent further damage.
Relentless: Once activated, a circuit breaker should remain in effect until the underlying issue is resolved.
Just: A circuit breaker should be used judiciously, only when necessary to protect the system.

🌟 Features

Type-safe implementation using PHP 8.1+
Configurable failure and success thresholds
Operation timeout handling
Fallback mechanism support
Metrics tracking
State transition management
PSR-3 compatible logging support

📦 Installation

Install via Composer:

Requirements:

PHP 8.1 or higher
ext-pcntl extension
ext-posix extension

🚀 Quick Start

🔄 Circuit States

The circuit breaker operates in three states:

CLOSED (Normal Operation)

All requests are allowed through
Failures are counted
When failures reach failureThreshold, transitions to OPEN

OPEN (Failure Prevention)

All requests are immediately rejected
After resetTimeout seconds, transitions to HALF-OPEN
Supports fallback responses during rejection

HALF-OPEN (Recovery Attempt)

Limited requests are allowed through
Successes are counted
After successThreshold successes, transitions to CLOSED
Any failure returns to OPEN state

📊 Metrics Tracking

The circuit breaker tracks key metrics:

🎯 Real-World Examples

1. API Client Protection

2. Database Query Protection

3. Microservice Communication

🔌 Framework Integration

Symfony Integration

Laravel Integration

⚙️ Advanced Configuration

Custom Timeout Handling

Adding Logging

🧪 Testing

Run the test suite:

The tests demonstrate:

State transition behavior
Failure counting
Success threshold management
Timeout handling
Metrics accuracy

🤝 Contributing

Fork the repository
Create a feature branch
Write tests for new features
Submit a pull request

📄 License

This library is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

All versions of alecto with dependencies

PHP Build Version

Package Version

Version 1.0.1 Release 05. Dec 2024
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of alecto from vendor cmatosbc

Requires php Version >=8.1
ext-pcntl Version *
ext-posix Version *

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package cmatosbc/alecto contains the following files

Loading the files please wait ....