CakePHP Gearman plugin

, _(*1)

Gearman task offloading for CakePHP 3., _(*2)

Requirements

PHP 5.5.9+
CakePHP 3.2+
Gearman Job Server
Gearman PHP extension

Why use this plugin?

Use this plugin to drastically reduce page load times by offloading time consuming processes (like sending emails and resizing uploaded images) to a Gearman Job Server., _(*3)

Installation

Install the plugin using Composer:, _(*4)

composer require cvo-technologies/cakephp-gearman

Now load the plugin by either running this shell command:, _(*5)

bin/cake plugin load CvoTechnologies/Gearman --bootstrap

or by manually adding the following line to config/bootstrap.php:, _(*6)

Plugin::load('CvoTechnologies/Gearman', ['bootstrap' => true]);

Lastly, add a new Gearman configuration section to (most likely) app.php:, _(*7)

    'Gearman' => [
        'Servers' => [
            '127.0.0.1:4730'
        ],
        'Jobs' => [

        ]
    ]

Optional: system verification

Before proceeding you might want to verify that the Gearman Job Server is actually up and running on your local system., _(*8)

On Ubuntu systems running sudo netstat -peanut | grep gearman should produce something similar to:, _(*9)

tcp      0     0 127.0.0.1:4730     0.0.0.0:*     LISTEN     0     9727     625/gearmand
tcp6     0     0 ::1:4730           :::*          LISTEN     0     9726     625/gearmand

Usage

Using this plugin comes down to:, _(*10)

Configuring your task(s)
Starting the WorkerShell on your local system
Offloading tasks from within your application code by using the execute() function found in the JobAwareTrait

To start the WorkerShell so it will listen for incoming tasks run the following command on your local system:, _(*11)

bin/cake worker

Built-in Tasks

Email Task

This plugin comes with a built-in email task that allows you to start offloading emails using the worker instantly., _(*12)

To enable the email task first add the following job to your Gearman configuration section:, _(*13)

    'Jobs' => [
        'className' => 'Email'
    ]

Then add the following worker configuration to your existing EmailTransporter configuration section (most likely found in app.php):, _(*14)

'worker' => [
    'className' => 'CvoTechnologies/Gearman.Worker',
    'transport' => 'default',
    'background' => true
]

Now all you need to do is use this EmailTransporter in your application when sending emails and it will automatically offload all email sending to the built-in task using the EmailTransporter defined in the transport key. E.g., _(*15)

$email = new Email('default');
$res = $email->from(['you@example.com' => 'Your Site'])
    ->to('recipient@sexample.com')
    ->subject('Testing cakephp-gearman built-in EmailTask')
    ->send('Your message');

If things went well you should see the worker providing feedback on tasks being processed shown below:, _(*16)

Worker feedback , _(*17)

Creating your own tasks

1. Create the Task

As an example we will create the following SleepTask that:, _(*18)

will be used as a Gearman job
must be created in src/Shell/Task/SleepTask.php
must contain a main() function

<?php
namespace CvoTechnologies\Gearman\Shell\Task;

use Cake\Console\Shell;

class SleepTask extends Shell
{

    public function main($workload, GearmanJob $job)
    {
        $job->sendStatus(0, 3);

        sleep($workload['timeout']);

        $job->sendStatus(1, 3);

        sleep($workload['timeout']);

        $job->sendStatus(2, 3);

        sleep($workload['timeout']);

        return array(
            'total_timeout' => $workload['timeout'] * 3
        );
    }
}

Please note that the plugin will take care of arrays and objects. When you submit an array in the task, you will receive an array in the workload., _(*19)