Looking to hire Laravel developers? Try LaraJobs

laravel-queue-watcher maintained by mennen-online

Description
Automatically restart Queue when local PHP files change
Last update
2026/05/22 16:27 (dev-master)
License
Downloads
8 059

Comments
comments powered by Disqus

Automatically restart Queue when local PHP files change

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

Inspired by spatie/laravel-horizon-watcher, this package contains Artisan Command queue:watch that will start the default Queue worker and automatically restart it when any PHP file is created, updated or deleted.

Also you can provide the --queue= option to define another queue than default to be watched.

To disable Job and Queue Timeout, use the --timeout= option with value 0.

This command is meant to be used in local environment.

Installation

You can install the package via composer:

composer require mennen-online/laravel-queue-watcher --dev

This is the contents of the published config file:

return [
    /*
     * Laravel Queue will be restarted when any PHP file inside these directories
     * get created, updated or deleted. You can also specify other kinds
     * of files here.
     */
    'paths' => [
        app_path(),
        config_path(),
        database_path(),
        resource_path('views'),
        base_path('.env'),
        base_path('composer.lock'),
    ],

    /*
     * This command will be executed to start Laravel Queue.
     */
    'command' => 'php artisan queue:work',
];

Usage

Run php artisan queue:watch to start default queue. When a PHP file in your project gets created, updated or deleted, Queue will automatically restart.

Run php artisan queue:watch --queue=another_queue to start another_queue and restart it automatically.

Run php artisan queue:watch --timeout=0 to disable queue worker timeout.

Testing

composer test

Credits

License

The MIT License (MIT). Please see License File for more information.