Getting Started with Gearman in PHP: Install, Configure, and Run Distributed Tasks

Overview

Gearman is an open‑source distributed task queue that splits complex jobs into independent sub‑tasks, dispatches them to multiple servers, and aggregates the results. It is useful for asynchronous processing, batch computation, or any scenario requiring distributed collaboration.

Installation

Install the Gearman daemon on a Linux host:

// RHEL/Fedora
yum install gearmand

// Debian/Ubuntu
apt install gearman-job-server

Starting the Service

After installation, launch the daemon in the background: gearmand -d The -d flag runs Gearman as a daemon (background process).

PHP Extension Installation

Install the Gearman PHP extension via PECL and enable it in php.ini:

pecl install gearman
extension=gearman.so

Getting Started with PHP

Simple string‑reversal task

Worker (Server‑side) Code

<?php
// worker.php
$worker = new GearmanWorker();
$worker->addServer(); // connect to default port 4730
$worker->addFunction("reverse_string", function($job) {
    $workload = $job->workload(); // get task data
    $result = strrev($workload); // reverse the string
    return $result; // return result
});

echo "Worker 已启动，等待任务...
";
while ($worker->work());

Client (Producer) Code

<?php
// client.php
$client = new GearmanClient();
$client->addServer(); // connect to server

$text = "Hello Gearman!"; // task payload
$result = $client->do("reverse_string", $text); // synchronous call

echo "原始字符串: {$text}
";
echo "反转结果: {$result}
";

Run Flow

Start the worker: php worker.php Execute the client:

php client.php

The client sends the task to the worker, the worker processes it, and the result is returned to the client.

This example demonstrates the basic steps to use Gearman with PHP. In real projects you can define additional task types, implement more complex processing logic, and fully exploit Gearman's distributed scheduling capabilities.