PHPackages                             ignashevroman/laravel-redis-sentinel-retry - 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. [Caching](/categories/caching)
4. /
5. ignashevroman/laravel-redis-sentinel-retry

ActiveLibrary[Caching](/categories/caching)

ignashevroman/laravel-redis-sentinel-retry
==========================================

Redis Sentinel connector for Laravel with runtime failover and retry support.

1.0.0(1y ago)5666↓84.6%[3 PRs](https://github.com/ignashevroman/laravel-redis-sentinel-retry/pulls)MITPHPPHP ^8.1CI passing

Since Apr 25Pushed 6mo ago2 watchersCompare

[ Source](https://github.com/ignashevroman/laravel-redis-sentinel-retry)[ Packagist](https://packagist.org/packages/ignashevroman/laravel-redis-sentinel-retry)[ Docs](https://github.com/ignashevroman/laravel-redis-sentinel-retry)[ RSS](/packages/ignashevroman-laravel-redis-sentinel-retry/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (1)Dependencies (5)Versions (5)Used By (0)

Laravel Redis Sentinel Retry
============================

[](#laravel-redis-sentinel-retry)

[![Latest Stable Version](https://camo.githubusercontent.com/f35aedeaa4da8e0514f3a0e731d4e4f16321e56e315f08fb3e5513c745d277b2/687474703a2f2f706f7365722e707567782e6f72672f69676e6173686576726f6d616e2f6c61726176656c2d72656469732d73656e74696e656c2d72657472792f76)](https://packagist.org/packages/ignashevroman/laravel-redis-sentinel-retry)[![Total Downloads](https://camo.githubusercontent.com/d7cae4f2709116ded49e7ab13aea21104ab94c03083261e8c8a772b1016e7cca/687474703a2f2f706f7365722e707567782e6f72672f69676e6173686576726f6d616e2f6c61726176656c2d72656469732d73656e74696e656c2d72657472792f646f776e6c6f616473)](https://packagist.org/packages/ignashevroman/laravel-redis-sentinel-retry)[![License](https://camo.githubusercontent.com/bb6aa6ede0a89424f8e8f87530e3272f57a2b7160e3b7bf2f10ce300936ecbc2/687474703a2f2f706f7365722e707567782e6f72672f69676e6173686576726f6d616e2f6c61726176656c2d72656469732d73656e74696e656c2d72657472792f6c6963656e7365)](https://packagist.org/packages/ignashevroman/laravel-redis-sentinel-retry)[![PHP Version Require](https://camo.githubusercontent.com/9baa08324c0de598bd7a06a9b83d41d381673f6b6a0fb05a02722b24b9a3caea/687474703a2f2f706f7365722e707567782e6f72672f69676e6173686576726f6d616e2f6c61726176656c2d72656469732d73656e74696e656c2d72657472792f726571756972652f706870)](https://packagist.org/packages/ignashevroman/laravel-redis-sentinel-retry)[![Tests](https://github.com/ignashevroman/laravel-redis-sentinel-retry/workflows/Tests/badge.svg)](https://github.com/ignashevroman/laravel-redis-sentinel-retry/actions?query=workflow%3ATests)[![Quality Gate Status](https://camo.githubusercontent.com/4313dc1f65ff1ff4f6b121b8b3c27f16b2c7afa87b8835105f3f3f84ae35d34e/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d69676e6173686576726f6d616e5f6c61726176656c2d72656469732d73656e74696e656c2d7265747279266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/dashboard?id=ignashevroman_laravel-redis-sentinel-retry)[![Maintainability Rating](https://camo.githubusercontent.com/deff6fee83b0909f4a96dbc9e9d6b041635f451b384124301a2de368c2a2f501/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d69676e6173686576726f6d616e5f6c61726176656c2d72656469732d73656e74696e656c2d7265747279266d65747269633d7371616c655f726174696e67)](https://sonarcloud.io/dashboard?id=ignashevroman_laravel-redis-sentinel-retry)[![Reliability Rating](https://camo.githubusercontent.com/5d6b1dba59654905f6e0e21be889a3054e2de1634815d2d1022587cae09f0bd2/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d69676e6173686576726f6d616e5f6c61726176656c2d72656469732d73656e74696e656c2d7265747279266d65747269633d72656c696162696c6974795f726174696e67)](https://sonarcloud.io/dashboard?id=ignashevroman_laravel-redis-sentinel-retry)[![Security Rating](https://camo.githubusercontent.com/c49bbd8ddd1aaeec7b9d7e89699079c2013f0ad888bc2d65884231c6ac9acfef/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d69676e6173686576726f6d616e5f6c61726176656c2d72656469732d73656e74696e656c2d7265747279266d65747269633d73656375726974795f726174696e67)](https://sonarcloud.io/dashboard?id=ignashevroman_laravel-redis-sentinel-retry)[![Vulnerabilities](https://camo.githubusercontent.com/162b72720637a9c841ae7dde23e44e5c896f33cf1625b29897b8ce79e3bc76d7/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d69676e6173686576726f6d616e5f6c61726176656c2d72656469732d73656e74696e656c2d7265747279266d65747269633d76756c6e65726162696c6974696573)](https://sonarcloud.io/dashboard?id=ignashevroman_laravel-redis-sentinel-retry)[![codecov](https://camo.githubusercontent.com/84472670e4b0ab767c6d6b5ac5781eb510dff0c0ff819481e4d85c805bfb7506/68747470733a2f2f636f6465636f762e696f2f67682f69676e6173686576726f6d616e2f6c61726176656c2d72656469732d73656e74696e656c2d72657472792f6272616e63682f6d61696e2f67726170682f62616467652e7376673f746f6b656e3d5a334441535a4744364d)](https://codecov.io/gh/ignashevroman/laravel-redis-sentinel-retry)

Overview
--------

[](#overview)

This package extends the standard Redis integration in Laravel, enabling it to work with Redis Sentinel while providing automatic failover handling and retry logic for transient errors.

It is based on the [Namoshek/laravel-redis-sentinel](https://github.com/Namoshek/laravel-redis-sentinel) package, with enhancements for retries and failover handling.

### Features:

[](#features)

- Connects to Redis through Sentinel.
- Retries on connection failure and failover.
- Uses `PhpRedis` extension for Redis connections.
- Simple configuration with Laravel built-in Redis system.

### Comparison with `namoshek/laravel-redis-sentinel`

[](#comparison-with-namosheklaravel-redis-sentinel)

Feature`ignashevroman/laravel-redis-sentinel-retry``namoshek/laravel-redis-sentinel`Connection via Redis Sentinel✅✅Easy integration✅✅Automatic retry on connection failures✅❌Failover during runtime✅❌Configurable retry attempts and delays✅❌Focus on production stability✅❌Error handling strategyCatch and retryImmediate exceptionInstallation
------------

[](#installation)

Install the package via Composer:

```
composer require ignashevroman/laravel-redis-sentinel-retry
```

Configuration
-------------

[](#configuration)

In your `config/database.php`, add a new connection entry under the `redis` array, which uses the `phpredis-sentinel` client.

```
'redis' => [
    'client' => env('REDIS_CLIENT', 'phpredis-sentinel'),

    'default' => [
        'sentinel_host' => env('REDIS_SENTINEL_HOST', '127.0.0.1'),
        'sentinel_port' => (int) env('REDIS_SENTINEL_PORT', 26379),
        'sentinel_service' => env('REDIS_SENTINEL_SERVICE', 'mymaster'),
        'sentinel_timeout' => (float) env('REDIS_SENTINEL_TIMEOUT', 0),
        'sentinel_persistent' => env('REDIS_SENTINEL_PERSISTENT'),
        'sentinel_retry_interval' => (int) env('REDIS_SENTINEL_RETRY_INTERVAL', 0),
        'sentinel_read_timeout' => (float) env('REDIS_SENTINEL_READ_TIMEOUT', 0),
        'sentinel_username' => env('REDIS_SENTINEL_USERNAME'),
        'sentinel_password' => env('REDIS_SENTINEL_PASSWORD'),
        'password' => env('REDIS_PASSWORD'),
        'database' => (int) env('REDIS_DB', 0),

        // Additional options for retry functionality
        'sentinel_max_retries' => env('REDIS_SENTINEL_MAX_RETRIES', 3),
        'sentinel_retry_delay' => env('REDIS_SENTINEL_RETRY_DELAY', 100_000),
    ]
],
```

> **Note:** The configuration options are the same as in [namoshek/laravel-redis-sentinel](https://github.com/Namoshek/laravel-redis-sentinel), with two additional options for retry functionality:

- `sentinel_max_retries`: The number of retry attempts for Redis operations (default: 3).
- `sentinel_retry_delay`: The delay between retries in microseconds (default: 100,000).

Differences in Implementation:
------------------------------

[](#differences-in-implementation)

1. **Retry Logic (Retries)**

    - This implementation introduces **retry logic** to handle transient errors such as **temporary connection failures** or **readonly states**. This allows automatic retries of requests if Redis becomes operational again after a failure.
    - In the case of an error like "READONLY" or a connection loss, the client will automatically retry the connection multiple times, improving the system's resilience.
2. **Integration with Redis Sentinel:**

    - This implementation enhances the **automatic failover mechanism** with Redis Sentinel. When the primary Redis server fails, the system automatically switches to a new master, if possible.
    - The **new master** is selected via **Redis Sentinel**, and if the current client loses connection or becomes "readonly", it tries to reconnect to the new master, taking into account settings for **retry attempts and delays**.
3. **Configuration Parameters:**

    - Two new configuration parameters were added to this package:
        - `sentinel_max_retries` — the maximum number of reconnection attempts.
        - `sentinel_retry_delay` — the delay between reconnection attempts.
    - These parameters provide flexibility in configuring the number of retries and delays for reconnection in case of failures.
4. **RedisWrapper Reconnection Logic:**

    - The **RedisWrapper** class manages the Redis client and encapsulates the retry logic, error checking, and failover handling.
    - If the connection is lost or becomes readonly, RedisWrapper automatically retries the connection for a set number of attempts, improving Redis availability.
5. **Error Handling in RedisWrapper:**

    - When an error occurs, such as a lost connection or readonly error, RedisWrapper attempts to **reconnect** through **handleFailover** (a method that manages reconnection).
    - If Redis does not recover after several attempts, an exception is thrown, just like in a standard Redis error scenario.

In general, this implementation focuses on improving fault tolerance and automating Redis connection management with Redis Sentinel, along with additional settings for controlling retry attempts and delay between reconnections.

License
-------

[](#license)

This package is licensed under the MIT License. See the [LICENSE](LICENSE.md) file for more information.

Acknowledgments
---------------

[](#acknowledgments)

A special thanks to the Namoshek team for their excellent work on the original [laravel-redis-sentinel](https://github.com/Namoshek/laravel-redis-sentinel) package, which served as the foundation for this package. This package extends their work by adding automatic retry functionality for Redis operations during failover scenarios.

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance57

Moderate activity, may be stable

Popularity21

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 63.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

435d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/47656668?v=4)[ignashevroman](/maintainers/ignashevroman)[@ignashevroman](https://github.com/ignashevroman)

---

Top Contributors

[![Namoshek](https://avatars.githubusercontent.com/u/8877609?v=4)](https://github.com/Namoshek "Namoshek (52 commits)")[![ignashevroman](https://avatars.githubusercontent.com/u/47656668?v=4)](https://github.com/ignashevroman "ignashevroman (23 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![misakstvanu](https://avatars.githubusercontent.com/u/42741294?v=4)](https://github.com/misakstvanu "misakstvanu (1 commits)")[![Alhubing](https://avatars.githubusercontent.com/u/16296784?v=4)](https://github.com/Alhubing "Alhubing (1 commits)")[![OrangeJuiced](https://avatars.githubusercontent.com/u/22561290?v=4)](https://github.com/OrangeJuiced "OrangeJuiced (1 commits)")[![igoooor](https://avatars.githubusercontent.com/u/1036285?v=4)](https://github.com/igoooor "igoooor (1 commits)")[![miladev95](https://avatars.githubusercontent.com/u/35612406?v=4)](https://github.com/miladev95 "miladev95 (1 commits)")

---

Tags

laravelredisretrysentinelfailover

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/ignashevroman-laravel-redis-sentinel-retry/health.svg)

```
[![Health](https://phpackages.com/badges/ignashevroman-laravel-redis-sentinel-retry/health.svg)](https://phpackages.com/packages/ignashevroman-laravel-redis-sentinel-retry)
```

###  Alternatives

[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k15.1M132](/packages/laravel-pulse)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.2k95.4M307](/packages/laravel-horizon)[laravel/sail

Docker files for running a basic Laravel application.

1.9k205.7M1.3k](/packages/laravel-sail)[illuminate/database

The Illuminate Database package.

2.8k54.9M11.7k](/packages/illuminate-database)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M201](/packages/laravel-ai)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)