Overview
Forge’s site management dashboard allows you to easily create as many Laravel queue workers as you like. Queue workers will automatically be monitored by Supervisor, and will be restarted if they crash. All workers will start automatically if the server is restarted.Creating A Queue Worker
You can create a new queue worker within the site’s management dashboard. The “New Worker” form is a wrapper around the Laravel queue feature. You can read more about queues in the full Laravel queue documentation. When creating a new queue worker, you may select a version of PHP that is already installed on the server. The selected version of PHP will be used to execute the queue worker.Laravel Horizon
If your Laravel application is using Laravel Horizon, you should not setup queue workers as described above. Instead, you may enable Horizon on Forge using Forge’s “daemon” feature. First, create a server daemon that executes thephp artisan horizon
Artisan command from your site’s root directory.
Next, add the php artisan horizon:terminate
Artisan command to your site’s deployment script, as described in Horizon’s deployment documentation.
Finally, if you wish to use Horizon’s metrics graphs, you should configure the scheduled job for horizon:snapshot
in your application code. In addition, you should define a Scheduler task within Forge for the php artisan schedule:run
Artisan command if you have not already done so.
Restarting Queue Workers After Deployment
When deploying your application, it is important that your existing queue workers or Horizon processes reflect the latest changes to your application. This can be achieved by gracefully restarting these services from your deployment script: When using queue workers:The
queue:restart
command requires a cache driver that persists data between requests. If your application’s cache driver is set to array
, the command will fail silently because the array
driver stores data in memory that is lost between requests.Circle Permissions
You may grant a circle member authority to create and manage queue workers by granting thesite:manage-queues
permission.