Download the PHP package rnd-cosoft/queue without Composer
On this page you can find all versions of the php package rnd-cosoft/queue. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rnd-cosoft/queue
More information about rnd-cosoft/queue
Files in rnd-cosoft/queue
Package queue
Short Description Laminas module that integrates with various queue management systems
License BSD-3-Clause
Homepage https://github.com/Webador/SlmQueue
Informations about the package queue
SlmQueue
SlmQueue is a job queue abstraction layer for Laminas (formerly Zend Framework) and Mezzio (formerly Zend Expressive) applications. It supports various job queue systems and makes your application independent from the underlying system you use. The currently supported systems have each their own adapter library:
- Doctrine ORM
- RabbitMQ
- Amazon SQS (outdated, maintainers wanted)
When to use
A job queue helps to offload long or memory-intensive processes from the HTTP requests clients sent to the Laminas application. This will make your response times shorter and your visitors happier. There are many use cases for asynchronous jobs and a few examples are:
- Send an email
- Create a PDF file
- Connect to a third party server over HTTP
In all cases you want to serve the response as soon as possible to your visitor, without letting them wait for this long process. SlmQueue enables you to implement a job queue system very easily within your existing application.
Installation
SlmQueue works with Composer. Make sure you have the composer.phar downloaded and you have a
composer.json
file at the root of your project. To install it, add the following line into your composer.json
file:
After installation of the package, you need to complete the following steps to use SlmQueue:
- Enable the module by adding
SlmQueue
in yourapplication.config.php
file. - Copy the
slm_queue.global.php.dist
(you can find this file in theconfig
folder of SlmQueue) into yourconfig/autoload
folder and apply any setting you want.
NB. SlmQueue is a skeleton and therefore useless by itself. Enable an adapter to give you the implementation details you need to push jobs into the queue. Install one of the available adapters (SlmQueueDoctrine, SlmQueueRabbitMq, or SlmQueueSqs).
Requirements
- PHP >= 7.4
- laminas-servicemanager >= 3.3.1
Code samples
Below are a few snippets which show the power of SlmQueue in your application. The full documentation is available in docs/ directory.
A sample job to send an email with php's mail()
might look like this:
If you want to inject this job into a queue, you can do this for instance in your controller:
Now the above code lets you insert jobs in a queue, but then you need to spin up a worker which can process these jobs.
SlmQueue integrates with laminas-cli
for command line usage. You can start up a worker for queue "default" with the following command:
Contributing
SlmQueue is developed by various fanatic Laminas users. The code is written to be as generic as possible for Laminas applications. If you want to contribute to SlmQueue, fork this repository and start hacking!
Any bugs can be reported as an issue at GitHub. If you want to contribute, please be aware of the following guidelines:
- Fork the project to your own repository
- Use branches to work on your own part
- Create a Pull Request at the canonical SlmQueue repository
- Make sure to cover changes with the right amount of unit tests
- If you add a new feature, please work on some documentation as well
For long-term contributors, push access to this repository is granted.
Who to thank?
Jurian Sluiman and Michaël Gallego did the initial work on creating this repo, and maintained it for a long time.
Currently it is maintained by:
All versions of queue with dependencies
ext-json Version *
laminas/laminas-eventmanager Version ^3.4
laminas/laminas-servicemanager Version ^3.11
laminas/laminas-stdlib Version ^3.7.1
laminas/laminas-cli Version ^1.2