PHPackages                             oeltimacreation/php-simplequeue - 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. oeltimacreation/php-simplequeue

ActiveLibrary[Caching](/categories/caching)

oeltimacreation/php-simplequeue
===============================

A lightweight, framework-agnostic background job queue system for PHP with Redis and database drivers

1.3.0(2w ago)3186MITPHPPHP ^8.1CI passing

Since Jan 7Pushed 1w agoCompare

[ Source](https://github.com/oeltimacreation/php-simplequeue)[ Packagist](https://packagist.org/packages/oeltimacreation/php-simplequeue)[ Docs](https://github.com/oeltimacreation/php-simplequeue)[ RSS](/packages/oeltimacreation-php-simplequeue/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (12)Versions (12)Used By (0)

OeltimaCreation PHP SimpleQueue
===============================

[](#oeltimacreation-php-simplequeue)

A lightweight, framework-agnostic background job queue system for PHP. Supports Redis and database-backed queues with automatic retries, progress tracking, and graceful shutdown.

Features
--------

[](#features)

- **Framework Agnostic**: Works with any PHP framework or standalone applications
- **Multiple Queue Drivers**: Redis (recommended) and Database polling
- **Automatic Retries**: Configurable retry with exponential backoff
- **Progress Tracking**: Report job progress with percentage and messages
- **Graceful Shutdown**: Handles SIGTERM/SIGINT for clean worker termination
- **Singleton Worker**: File locking prevents multiple workers from running
- **Stale Job Recovery**: Automatically recovers jobs stuck in running state
- **PSR Compliant**: Uses PSR-3 Logger and PSR-11 Container interfaces

Requirements
------------

[](#requirements)

- PHP 8.2 or higher
- Redis >= 7.0 or Valkey >= 8.0 (optional, for Redis/Valkey driver)
- PDO (optional, for database driver)

Installation
------------

[](#installation)

```
composer require oeltimacreation/php-simplequeue
```

For Redis support:

```
composer require predis/predis
```

Quick Start
-----------

[](#quick-start)

### 1. Create a Job Handler

[](#1-create-a-job-handler)

```