PHPackages                             insolita/circular-queue - 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. insolita/circular-queue

ActiveLibrary[Utility & Helpers](/categories/utility)

insolita/circular-queue
=======================

Circular queue with redis implementation

1.0.1(6y ago)4381[1 issues](https://github.com/Insolita/circular-queue/issues)MITPHPPHP >=7.0CI failing

Since Nov 3Pushed 6y ago3 watchersCompare

[ Source](https://github.com/Insolita/circular-queue)[ Packagist](https://packagist.org/packages/insolita/circular-queue)[ RSS](/packages/insolita-circular-queue/feed)WikiDiscussions master Synced 3d ago

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

Circular Queue
==============

[](#circular-queue)

Circular Queue with redis implementation for distribution of shared data Useful for resource balancing, parsing

[![Build Status](https://camo.githubusercontent.com/406019bcfb7248c95309ea31e7541e6f3113f965250370c0085da6ee037d5f1c/68747470733a2f2f7472617669732d63692e6f72672f496e736f6c6974612f63697263756c61722d71756575652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/Insolita/circular-queue)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/9e430530446e8be01dcea6ee8e29e3d405813a7eccde6bfc807a553bffe5a91a/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f496e736f6c6974612f63697263756c61722d71756575652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/Insolita/circular-queue/?branch=master)[![SensioLabsInsight](https://camo.githubusercontent.com/b8dfe209ec0ebe392026dc032ac1530f7f2a0805b13acf286b2cb3a730f684b5/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f35336632386363302d663732612d346334312d616466302d3165373736626332663639342f6269672e706e67)](https://insight.sensiolabs.com/projects/53f28cc0-f72a-4c41-adf0-1e776bc2f694)

### Install

[](#install)

`composer require insolita/circular-queue`

### Usage

[](#usage)

##### SimpleCircularQueue

[](#simplecircularqueue)

```
  $q = new SimpleCircularQueue(
       'queueName',
        new AsIsConverter(),              // insolita\cqueue\Contracts\PayloadConverterInterface
        new OnEmptyQueueException(),      // insolita\cqueue\Contracts\EmptyQueueBehaviorInterface
        new PredisStorage(new Client())   // insolita\cqueue\Contracts\StorageInterface
  );

  $q->fill(['alpha', 'beta', 'gamma', 'delta']);
  $q->next(); //alpha
  $q->next(); //beta
  $q->next(); //gamma
  $q->next(); //delta
  $q->next(); //alpha
  $q->next(); //beta
  $q->next(); //gamma
  $q->countQueued();//4
  $q->purgeQueued();//clear queue
  ...
```

##### CircularQueue

[](#circularqueue)

```
  $q = new CircularQueue(
       'queueName',
        new AsIsConverter(),              // insolita\cqueue\Contracts\PayloadConverterInterface
        new OnEmptyQueueException(),      // insolita\cqueue\Contracts\EmptyQueueBehaviorInterface
        new PredisStorage(new Client())   // insolita\cqueue\Contracts\StorageInterface
  );
    $q->fill(['alpha', 'beta', 'gamma', 'delta']);
    $item = $q->pull(); //alpha - extract item from queue
    $q->resume($item); // resume item in queue

    $item1 = $q->pull(60); //Item will be resumed in queue after 60 seconds
    $item2 = $q->pull();
    $q->resume($item2, 120); //Item will be resumed in queue after 120 seconds
    $item3 = $q->pull();
    $q->resumeAt($item3, time()+100500); //Item will be resumed  after concrete timestamp
    $q->countTotal()   //4
    $q->countQueued()  //1
    $q->countDelayed() //3
    $q->listDelayed()  // ['beta', 'gamma', 'delta']
    $q->resumeAllDelayed(); //Force resume all delayed in queue
    $q->purgeDelayed(); //Remove all delayed
```

#### Manager

[](#manager)

```
   $q1 = new CircularQueue(
           'firstQueue',
            new SerializableConverter(),
            new OnEmptyQueueException(),
            new PhpRedisStorage(new \Redis())
         );
   $manager = new Manager([$q1]);
   $manager->add(new CircularQueue(
           'secondQueue',
            new SerializableConverter(),
            new OnEmptyQueueException(),
            new PhpRedisStorage(new \Redis())
   ));

   $manager->has('secondQueue'); //true
   $manager->has('fooQueue'); //false

   $manager->queue('firstQueue')->fill([...]);
   $manager->queue('secondQueue')->fill([...]);
   ...
   $manager->remove('firstQueue');
   $manager->remove('secondQueue');
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance15

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 89.5% 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

Every ~239 days

Total

4

Last Release

2397d ago

Major Versions

0.0.2 → 1.0.02018-04-09

### Community

Maintainers

![](https://www.gravatar.com/avatar/40f26825f8c130796e3151e6c076721cf5bb222c42148102bb31a341a1a5c789?d=identicon)[Insolita](/maintainers/Insolita)

---

Top Contributors

[![Insolita](https://avatars.githubusercontent.com/u/1847402?v=4)](https://github.com/Insolita "Insolita (17 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")

---

Tags

hacktoberfest

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/insolita-circular-queue/health.svg)

```
[![Health](https://phpackages.com/badges/insolita-circular-queue/health.svg)](https://phpackages.com/packages/insolita-circular-queue)
```

###  Alternatives

[ashallendesign/short-url

A Laravel package for creating shortened URLs for your web apps.

1.4k1.9M4](/packages/ashallendesign-short-url)[solspace/craft-freeform

The most flexible and user-friendly form building plugin!

52664.9k12](/packages/solspace-craft-freeform)[intervention/zodiac

Zodiac Sign Calculator

58191.7k](/packages/intervention-zodiac)[erlandmuchasaj/laravel-gzip

Gzip your responses.

40129.3k2](/packages/erlandmuchasaj-laravel-gzip)[solspace/craft-calendar

The most powerful event management and calendaring plugin!

1830.8k1](/packages/solspace-craft-calendar)

PHPackages © 2026

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