PHPackages                             dinoqqq/crystal - 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. [Queues & Workers](/categories/queues)
4. /
5. dinoqqq/crystal

ActiveLibrary[Queues & Workers](/categories/queues)

dinoqqq/crystal
===============

Queue worker to easily manage recurring tasks

v3.0.4(4mo ago)19.5k↓50%2[1 issues](https://github.com/dinoqqq/crystal/issues)MITPHPPHP >=7.2

Since Jul 7Pushed 4mo ago2 watchersCompare

[ Source](https://github.com/dinoqqq/crystal)[ Packagist](https://packagist.org/packages/dinoqqq/crystal)[ RSS](/packages/dinoqqq-crystal/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (5)Versions (27)Used By (0)

Crystal: A queue worker for recurring tasks
===========================================

[](#crystal-a-queue-worker-for-recurring-tasks)

Crystal is a queue worker optimized for recurring tasks that need to be processed in an easy manageable way.

Features
--------

[](#features)

- A clear overview of which tasks are recurring (in a DB table).
- Graceful shutdown of tasks (needed for tasks that have an unknown running time).
- Manageable system resources; by setting the total number of tasks/processes allowed to be processed simultaneously.
- Configurable dependencies between tasks (order of running).
- Easily dedicate more or less resources to tasks.

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

[](#requirements)

- PHP7.2+
- MySQL / MariaDB

Get Started
-----------

[](#get-started)

### Install via Composer

[](#install-via-composer)

`composer require dinoqqq/crystal`

### Usage

[](#usage)

- Create a [config](CRYSTAL.md#define-the-config).
- Create a [TaskFactory](CRYSTAL.md#the-taskfactory-class), to define tasks.
- Create a [Queuer](CRYSTAL.md#the-queuer-class), to schedule processes.
- Create [cron entries](CRYSTAL.md#cron-entries) to start the system and keep it running.
- Create a [Controller](CRYSTAL.md#the-controller), to catch the cron entries and start the heartbeat processes.

Development: running tests
--------------------------

[](#development-running-tests)

To get the tests running follow these steps:

1. Set the database settings in `/config/database.php`
2. Run the migrations in `/migration`
3. Run `composer update`
4. Run `/vendor/bin/phpunit`

Read the extended README [here](CRYSTAL.md).

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance57

Moderate activity, may be stable

Popularity27

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~69 days

Recently: every ~392 days

Total

25

Last Release

124d ago

Major Versions

v0.1.0 → v1.0.02021-07-07

v1.3.2 → v2.0.02021-09-25

v1.x-dev → v2.0.12021-09-25

v2.0.1 → v3.0.02021-09-30

PHP version history (2 changes)v0.1.0PHP >=7.0 <7.3

v1.0.2PHP >=7.2

### Community

Maintainers

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

---

Top Contributors

[![roland-bhb](https://avatars.githubusercontent.com/u/135239096?v=4)](https://github.com/roland-bhb "roland-bhb (3 commits)")[![dinoqqq](https://avatars.githubusercontent.com/u/2246538?v=4)](https://github.com/dinoqqq "dinoqqq (2 commits)")[![G0LEM-XIV](https://avatars.githubusercontent.com/u/91133074?v=4)](https://github.com/G0LEM-XIV "G0LEM-XIV (2 commits)")[![ropoli74](https://avatars.githubusercontent.com/u/20184556?v=4)](https://github.com/ropoli74 "ropoli74 (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/dinoqqq-crystal/health.svg)

```
[![Health](https://phpackages.com/badges/dinoqqq-crystal/health.svg)](https://phpackages.com/packages/dinoqqq-crystal)
```

###  Alternatives

[jolicode/castor

A lightweight and modern task runner. Automate everything. In PHP.

53541.0k3](/packages/jolicode-castor)[riki137/multitron

Tool for managing fast both asynchronous and multi-threaded execution of tasks. Focused on performance and pleasant CLI interface.

9016.8k](/packages/riki137-multitron)[hyperf/amqp

A amqplib for hyperf.

241.2M56](/packages/hyperf-amqp)[amphp/cluster

Building multi-core network applications with PHP.

6224.8k1](/packages/amphp-cluster)[haozu/delay-queue

Delay queue based on redis

123.4k](/packages/haozu-delay-queue)

PHPackages © 2026

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