Download the PHP package kislayphp/queue without Composer
On this page you can find all versions of the php package kislayphp/queue. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kislayphp/queue
More information about kislayphp/queue
Files in kislayphp/queue
Package queue
Short Description Native PHP distributed job queue with a standalone queue server, producer client, worker runtime, retries, and DLQ support
License Apache-2.0
Homepage https://github.com/KislayPHP/queue
Informations about the package queue
Kislay Queue
Native PHP distributed job queue for long-running services. Phase 1 ships a standalone queue server, producer client, worker client, retries, delayed jobs, and DLQ support.
Part of the KislayPHP ecosystem.
What It Is
kislayphp/queue now has two modes:
Kislay\Queue\Serverfor the standalone queue nodeKislay\Queue\Clientfor producers and operational readsKislay\Queue\Workerfor consumersKislay\Queue\Jobfor ack/nack control inside a handlerKislay\Queue\Queueas the legacy local in-process queue for development fallback
Delivery model in 0.0.4:
- at-least-once delivery
- one leased job per worker fetch
- retries with backoff
- delayed jobs
- dead-letter queue support
- in-memory server state only
Install
Enable in php.ini:
5-Minute Quickstart
1. Start the queue server
2. Push a job
3. Run a worker
Architecture
Public API
Legacy local queue API remains available:
Queue Semantics
0.0.4 semantics are intentionally explicit:
push()creates a job inreadyordelayedWorker::consume()fetches one leased job at a time- if the handler returns
true, the worker acks the job - if the handler returns
false, the worker nacks the job - if a handler throws, the worker nacks the job and stops with the exception still raised
- if retries are exhausted, the job moves to the configured DLQ
Operational Notes
What 0.0.4 is good for:
- background task processing between services
- queue semantics for microservice workloads
- development and early production validation
- explicit retry / DLQ flows
What 0.0.4 does not do yet:
- durable persistence across queue server restarts
- worker concurrency inside one
consume()loop - distributed replication
- exactly-once delivery
If the queue server process stops, in-memory jobs are lost. That is the correct tradeoff for this phase; do not market it as durable yet.
End-to-End Example
See example.php for a minimal runnable server / producer / worker flow.
Ecosystem Fit
Use this module for job queue semantics.
Use eventbus for fanout and realtime pub/sub.
Typical flow:
Docs
- Full docs: https://skelves.com/kislayphp/docs/queue
- Insight articles: https://skelves.com/insights
License
Apache License 2.0