Nu-Coder Manual

PhpExpress Manual

PHP Joomla
Development

GearmanClient::setExceptionCallback	GearmanClient::setOptions

GearmanClient	Last updated: Mon, 26 Oct 2026

GearmanClient::setFailCallback

(PECL gearman >= 0.5.0)

GearmanClient::setFailCallback — Set callback for job failure

Description

public function GearmanClient::setFailCallback(callable $callback): bool

Sets the callback function to be used when a task does not complete successfully.

Note:
The callback will only be triggered for tasks that are added (e.g. by calling GearmanClient::addTask()) after calling this method.

Parameters

callback

A function or method to call. It should return a valid Gearman return value.

If no return statement is present, it defaults to GEARMAN_SUCCESS.

function callback(GearmanTask $task, mixed $context): int

task: The task this callback is called for.
context: Whatever has been passed to GearmanClient::addTask() (or equivalent method) as context.

Return Values

Returns true on success or false on failure.

See Also

GearmanClient::setDataCallback() - Callback function when there is a data packet for a task
GearmanClient::setCompleteCallback() - Set a function to be called on task completion
GearmanClient::setCreatedCallback() - Set a callback for when a task is queued
GearmanClient::setExceptionCallback() - Set a callback for worker exceptions
GearmanClient::setStatusCallback() - Set a callback for collecting task status
GearmanClient::setWarningCallback() - Set a callback for worker warnings
GearmanClient::setWorkloadCallback() - Set a callback for accepting incremental data updates

GearmanClient::setExceptionCallback	GearmanClient::setOptions

GearmanClient	Last updated: Mon, 26 Oct 2026