nayjest/symfony-worker-control

Console command for maintaining worker processes

PHP Worker Control

Console command for maintaining worker processes., _(*1)

Symfony Worker Control may be used as standalone script or included as lib to existing project., _(*2)

Dependencies

• php5+ | php7+ | hhvm
• symfony/console 3+ package
• pgrep & pkill command-line utilities

Installation

Installation as lib to existing project:, _(*3)

composer require nayjest/symfony-worker-control, _(*4)

Installation as standalone script:, _(*5)

git clone https://github.com/Nayjest/symfony-worker-control.git && cd symfony-worker-control && composer install && chmod +x workers, _(*6)

Testing

Code-style (PSR2):, _(*7)

1) Install code sniffer:, _(*8)

composer global require "squizlabs/php_codesniffer=*", _(*9)

2) Run code-style tests from symfony-worker-control folder, _(*10)

composer cs, _(*11)

Worker for tests:, _(*12)

tests/example-worker.php, _(*13)

Usage

workers [--qty QTY] [-o|--output OUTPUT] [-e|--errors ERRORS] [--] <action> <cmd>, _(*14)

Command may be executed directly (./workers ...) or as argument of php command (php workers ...)., _(*15)

See ./workers --help for help., _(*16)

Actions

start -- start QTY processes, _(*17)

restart -- stop all processes and then start QTY processes, _(*18)

stop -- stop all processes, _(*19)

maintain -- start QTY - N processes, where N — quantity of currently running processes., _(*20)

count -- print count of running processes, _(*21)

list -- print information about running processes, _(*22)

Options

--qty=<value> — specifies quantity of processes to start/restart/maintain If value isn't specified, DEFAULT_WORKER_QTY environment variable will be used. if DEFAULT_WORKER_QTY isn't defined, qty = 1, _(*23)

--output=<value> -o <value> output file for workers (STDOUT + STDERR if --errors not specified), following placeholder: {i} will be replaced to process number. Default value: /dev/null, _(*24)

--errors=<value> -e <value> output file for workers (STDERR), following placeholder: {i} will be replaced to process number., _(*25)

--quiet -q Do not output any message, _(*26)

Help: ./workers --help, _(*27)

Examples:, _(*28)

./workers start --qty=2 "php my_process.php", _(*29)

./workers restart --qty=3 "my_process.php", _(*30)

php workers maintain --qty=4 "php my_process.php", _(*31)

php workers stop "php my_process.php", _(*32)

Security

If you discover any security related issues, please email mail@vitaliy.in instead of using the issue tracker., _(*33)

License

© 2017—2018 Vitalii Stepanenko, _(*34)

Licensed under the MIT License., _(*35)

Please see License File for more information., _(*36)