GearmanClient::addTaskHigh()函数—用法及示例

函数名称：GearmanClient::addTaskHigh()

适用版本：Gearman PHP扩展版本 >= 0.5.0

用法：该函数用于向Gearman服务器添加一个高优先级的任务。

语法：

public GearmanClient::addTaskHigh(string $function_name, string $workload [, mixed $context [, string $unique ]])

参数：

• $function_name：要执行的任务函数的名称。
• $workload：要传递给任务函数的工作负载数据。
• $context（可选）：一个可选的上下文数据，可以是任意类型的数据。
• $unique（可选）：一个可选的唯一标识符，用于标识任务的唯一性。

返回值：如果成功添加任务，则返回一个唯一标识符字符串，否则返回false。

示例：

// 创建一个GearmanClient实例
$client = new GearmanClient();

// 添加一个高优先级的任务
$function_name = 'do_work';
$workload = 'This is the workload data';
$context = ['key' => 'value'];
$unique = 'unique_identifier';

$task_handle = $client->addTaskHigh($function_name, $workload, $context, $unique);

// 检查任务是否成功添加
if ($task_handle !== false) {
    echo "Task added successfully with handle: " . $task_handle;
} else {
    echo "Failed to add task";
}

// 提交任务给Gearman服务器
$client->runTasks();

以上示例代码中，我们创建了一个GearmanClient实例，并使用addTaskHigh()函数添加了一个高优先级的任务。我们指定了要执行的任务函数名称为'do_work'，工作负载数据为'This is the workload data'，上下文数据为['key' => 'value']，唯一标识符为'unique_identifier'。然后，我们检查任务是否成功添加，并通过调用runTasks()方法将任务提交给Gearman服务器进行执行。