What is the difference between queue:work --daemon and queue:listen

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?


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


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