README
Gearman JobServer implementation for Laravel
Gearman
Gearman is a MQ (Message Queue) provider with foreground and background capabilities. This makes it one of the few PHP-suited synchronous MQ handlers.
gearman.org
Laravel
Laravel is on of the leanest and meanest PHP Frameworks around - perfectly suited for rest API projects.
laravel.com
The package
The Jobserver package is a Gearman dispatch implementation for Laravel. The package functions as an abstraction layer to send both foreground as background jobs to a MQ server (Gearman in this case).
The Jobserver package is taylored to use in the 3-layer structure (app <-> api <-> worker).
Read more about installing and using the jobserver package here:
3-layer - JobServer package
3-Layer - Set up Message Queueing
Implementation
Add the package to your API dependencies. To use the local "synced" mode - skipping a local Gearman installation - add the models/Ghostjob.php file to your worker app/models directory.
To make the synced connection between the API and worker job function work, add "echo Ghostjob::evaluate ('controllerDispatch', $argv);" to the end of the required function files.
Installation
Add the Jobserver package to the composer requirements of your API project. In project/composer.json, add the koenbetsens/jobserver entry
array
(
'Illuminate\Foundation\Providers\ArtisanServiceProvider',
...
'Illuminate\Workbench\WorkbenchServiceProvider',
'koenbetsens\jobserver\JobServerServiceProvider'
)
The package has 2 modes: "Gearman mode" (default) and "Synchronized mode" to enable functional communication without an actual MQ install.
#### Gearman mode
If your Gearman server runs on the same machine as your API project, Jobserver will work out-of-the-box. To send your jobs to an external queue, create a config file named `app/config/gearman.php` to store your Gearman server location. You can add multiple servers, or single servers for multiple environments, by creating [config environment-folders](
http://laravel.com/docs/4.2/configuration#environment-configuration)
array
(
'gearman.project-url.ext' => '4730'
)
);
#### Synchronized (local) mode
To save yourself the hassle of installing Gearman locally for development, you can enabled the **sync mode** for **php-cli** based execution of the jobload. This mode will only work when debug mode is on, to prevent sync mode in production-level environments.
##### Configuration
The configuration can be added directly to your `app/config/
local/app.php` file. Your worker path points to the **job functions directory** (usually named `/jobs`)
true,
/**
|--------------------------------------------------------------------------
| Synchronized
|--------------------------------------------------------------------------
| If set, the API will call the worker directly, instead of using a jobserver.
**/
'synchronized' => true,
/**
|--------------------------------------------------------------------------
| Worker path
|--------------------------------------------------------------------------
| This path is used by the local Jobserver to sync a queue request.
**/
'worker' => array
(
'path' => '/path/to/project/worker/jobs'
)
);
##### Ghostjob model
We need to emulate a job model for syncronized usage. Copy the `/models/Ghostjob.php` file from the Jobserver package to the `app/models` folder in your worker project. Now you can selectively add the Ghostjob evaluation in the job-function files like this:
