73
votes

I'm settin up my offline job server. I've read the documentation but I still don't really see the differences between the two commands: artisan queue:work --daemon and artisan queue:listen. Which command should I use for running my daemons?

4

4 Answers

137
votes

Edit updated 2017-04-07:

There are now three ways to run your queue:

  • queue:work - this is the new "daemon" process (the flag is no longer required). The framework will fire up "once" - and then keep looping through the jobs. This will continue indefinitely. It uses less memory/cpu than queue:listen because the framework stays up the entire time. You must also remember to use queue:restart to force the queue to update any code changes you push during patching.

  • queue:work --once - this will fire up the framework, process one job, then shutdown. Useful for testing during development etc.

  • queue:listen - this will fire the framework up on every cycle, process one job, then fully shutdown, and then fire the framework up again etc and loop indefinitely. This means all memory/processes are released after each job is processed. If you have memory leaks with queue:work - give this a try.

The --daemon flag no longer has an effect on these commands.

Original answer:

There are two different issues listed.

There is artisan queue:work and artisan queue:listen

  • queue:work will simply pop off the next job in the queue, and process only that one job. This is a 'one off' command that will return to the command prompt once the one queue command is processed.
  • queue:listen will listen to the queue, and continue to process any queue commands it receives. This will continue running indefinitely until you stop it.

In Laravel >=4.2 there was a --daemon command added. The way it works is simply keeps running the queues directly, rather than rebooting the entire framework after every queue is processed. This is an optional command that significantly reduces the memory and cpu requirements of your queue.

The important point with the --daemon command is that when you upgrade your application, you need to specifically restart your queue with queue:restart, otherwise you could potentially get all sorts of strange errors as your queue would still have the old code in memory.

So to answer your question "Which command should I use for running my daemons?" - the answer is almost always queue:work --daemon

16
votes

Things have been changed but it was not mentioned in the document

 --daemon  Run the worker in daemon mode (Deprecated)

now by default php artisan queue:work runs in daemon mode,

so queue:work continue processing jobs without ever re-booting the framework

for run it once command is,

php artisan queue:work --once

5
votes

The most important difference is that queue:work --daemon does not restart the framework on each job, but queue:listen does. In fact, listen starts a whole new Laravel process for each job.

Try for yourself: Open 2 terminals and run work --daemon in one and listen in the other. The work window will execute jobs much faster than listen.

0
votes

As of Laravel 5.7 a new option --stop-when-empty has been added to the queue:work command. When using this option the current queue will be processed until it's empty, then the command will exit.

According to the documentation:

The --stop-when-empty option may be used to instruct the worker to process all jobs and then exit gracefully. This option can be useful when working Laravel queues within a Docker container if you wish to shutdown the container after the queue is empty:

php artisan queue:work --stop-when-empty