miserenkov / yii2-gearman
Yii2 component for gearman
Installs: 64
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Type:yii2-component
Requires
- php: >=5.5.0
- react/event-loop: 0.4.*
- yiisoft/yii2: ^2.0.6
Requires (Dev)
- codeception/codeception: ^2.2
Suggests
- ext-gearman: This library needs Gearman
This package is auto-updated.
Last update: 2024-11-04 21:46:05 UTC
README
This extension built on this and this. The goal of the project is opportunity of starting multiple worker processes on one machine.
Installation
It is recommended that you install the Gearman library through composer. To do so, add the following lines to your composer.json
file.
{ "require": { "miserenkov/yii2-gearman": "dev-master" } }
Configuration
'components' => [ 'gearman' => [ 'class' => 'miserenkov\gearman\Gearman', 'servers' => [ ['host' => '127.0.0.1', 'port' => 4730], ], 'user' => 'www-data', 'jobs' => [ 'syncCalendar' => [ 'class' => 'common\jobs\SyncCalendar' ], ... ] ] ], ... 'controllerMap' => [ 'gearman' => [ 'class' => 'miserenkov\gearman\controllers\GearmanController', 'gearmanComponent' => 'gearman' ], ... ],
Job example
namespace common\jobs; use miserenkov\gearman\JobBase; class SyncCalendar extends JobBase { public function execute(\GearmanJob $job = null) { // Do something } }
Manage workers
yii gearman/start 1 // start the worker with unique id yii gearman/restart 1 // restart worker yii gearman/stop 1 // stop worker
Example using Dispatcher
Yii::$app->gearman->getDispatcher()->background('syncCalendar', new JobWorkload([ 'params' => [ 'data' => 'value' ] ])); // run in background Yii::$app->gearman->getDispatcher()->execute('syncCalendar', new JobWorkload([ 'params' => [ 'data' => 'value' ] ])); // run synchronize
Example of Supervisor config to manage multiple workers
[program:yii-gearman-worker]
command=php [path_to_your_app]/yii gearman/start %(process_num)s
process_name=gearman-worker-%(process_num)s
priority=1
numprocs=5
numprocs_start=1
autorestart=true