# GearmanClient::setFailCallback

(PECL gearman >= 0.5.0)

GearmanClient::setFailCallback — Set callback for job failure

### 说明

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

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

> 注意:

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

### 参数

`callback`

  调用的函数或方法。应该返回有效的 Gearman 返回值。

  如果没有返回语句，默认是 `GEARMAN_SUCCESS`。

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

    调用此 callback 的任务。

  `context`

    Whatever has been passed to GearmanClient::addTask() (or equivalent method) as `context`.

### 返回值

成功时返回 `true`， 或者在失败时返回 `false`。

### 参见

- 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open