Download the PHP package dinoqqq/crystal without Composer
On this page you can find all versions of the php package dinoqqq/crystal. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download dinoqqq/crystal
More information about dinoqqq/crystal
Files in dinoqqq/crystal
Package crystal
Short Description Queue worker to easily manage recurring tasks
License MIT
Informations about the package crystal
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
- 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
- PHP7.2+
- MySQL / MariaDB
Get Started
Install via Composer
composer require dinoqqq/crystal
Usage
- Create a config.
- Create a TaskFactory, to define tasks.
- Create a Queuer, to schedule processes.
- Create cron entries to start the system and keep it running.
- Create a Controller, to catch the cron entries and start the heartbeat processes.
Development: running tests
To get the tests running follow these steps:
- Set the database settings in
/config/database.php - Run the migrations in
/migration - Run
composer update - Run
/vendor/bin/phpunit
Using Docker
A docker-compose.yml and Dockerfile are included to spin up a MySQL 8.0 instance and a PHP 8.3 CLI container for local development and tests. The schema in /migration/schema.sql is loaded automatically on first start.
MySQL is exposed on 127.0.0.1:3306 with:
- Database:
crystal - User / password:
crystal/crystal - Root password:
root
Set these in /config/database.php. Use mysql as the server when running from inside the PHP container, or 127.0.0.1 when running from the host:
Run composer and the test suite inside the PHP container:
To stop the containers: docker compose down. To also wipe the data volume: docker compose down -v.
Read the extended README here.
All versions of crystal with dependencies
ext-pcntl Version *
ext-pdo Version *
monolog/monolog Version ^3
catfan/medoo Version ^1.7
psr/container Version ^1.