Download the PHP package webparking/laravel-queue-ensurer without Composer

On this page you can find all versions of the php package webparking/laravel-queue-ensurer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-queue-ensurer

Laravel Queue Ensurer

Build Status Quality score Code coverage

This package provides a command (queue:ensure-processes) to allow running the Laravel queue worker (queue:work) from the Laravel schedule. This enables a cronjob to ensure that configured queue workers are running. It eliminates the need for a process manager like supervisord, which is not available in all production environments (like when working with DirectAdmin or most other server control panels).

Multiple queues can be configured and the number of desired processes can be configured per queue (which makes it possible to run multiple jobs in parallel). Doing so, allows having the queue configuration in your project's codebase.

This package doesn't care about which queue driver(s) you use and queue:restart still works as normal.

Installation

By default, the queue:ensure-processes command is configured to run once a minute, ensuring one worker for the default queue. So if that's all you desire, you're good to go.

Configuration

You can publish the configuration file to your project by running php artisan vendor:publish --provider="Webparking\QueueEnsurer\ServiceProvider" --tag="config".

The documentation for the configurable options can be found in the config file.

Working

The queue ensurer works by keeping a cache of process id's (PID's) it has started. Every time the ensurer runs, it does this:

  1. Remove any PID's of stopped processes from the cache. These processes may have been stopped by a server reboot, queue:restart or for any other reason.
  2. Kill processes belonging to no longer configured queue's and remove their PID's from the cache. When a queue was configured to have processes before, but is not configured now.
  3. Kill processes that are no longer required and remove their PID's from the cache. When the number of configured processes is lower than the number of running processes.
  4. Start new processes and add their PID's to the cache. When the number of configured processes is higher than the number of running processes.

This means that the ensurer will not take in account any processes it has not started itself.

For the PID cache, the ensurer uses a JSON file (storage/app/queue-listener-pids.json) instead of the Laravel cache mechanism. If the queue ensurer were to use the Laravel cache and the cache were to be cleared (php artisan cache:clear), the running processes would not be known to the ensurer any longer. Resulting in it starting new processes, without every killing the old ones.

Contribution and development

We're happy to receive pull requests or issues.

When developing, you can run composer test to execute all code quality checks and tests.

Future features

These are features we may add. We don't have a specific need for them now, but we acknowledge their usefulness and we will add them when we have some down time. Should you or your project require one or more of these future features earlier, please submit a PR or create an issue.

Licence and Postcardware

This software is open source and licensed under the MIT license.

If you use this software in your daily development we would appreciate to receive a postcard of your hometown.

Please send it to: Webparking BV, Cypresbaan 31a, 2908 LT Capelle aan den IJssel, The Netherlands


All versions of laravel-queue-ensurer with dependencies

PHP Build Version
Package Version
Requires php Version >=7.1.0
ext-json Version *
ext-posix Version *
illuminate/support Version ^5.5|^6.0|^7.0|^8.0
illuminate/console Version ^5.5|^6.0|^7.0|^8.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package webparking/laravel-queue-ensurer contains the following files

Loading the files please wait ...