2024 年 PHP 日本大会

Stomp::ack

stomp_ack

(PECL stomp >= 0.1.0)

Stomp::ack -- stomp_ack确认已消费消息

描述

面向对象风格 (方法)

public Stomp::ack(混合 $msg, 数组 $headers = ?): 布尔值

过程式风格

stomp_ack(资源 $link, 混合 $msg, 数组 $headers = ?): 布尔值

使用客户端确认来确认已从订阅中消费消息。

参数

link

仅过程式风格:由 stomp_connect() 返回的 stomp 连接标识符。

msg

要确认的消息/消息 ID。

headers

包含附加标头(例如:回执)的关联数组。

返回值

成功时返回 true,失败时返回 false

示例

示例 #1 面向对象风格

<?php

$queue
= '/queue/foo';
$msg = 'bar';

/* 连接 */
try {
$stomp = new Stomp('tcp://127.0.0.1:61613');
} catch(
StompException $e) {
die(
'连接失败: ' . $e->getMessage());
}

/* 发送消息到队列 'foo' */
$stomp->send($queue, $msg);

/* 订阅来自队列 'foo' 的消息 */
$stomp->subscribe($queue);

/* 读取帧 */
$frame = $stomp->readFrame();

if (
$frame->body === $msg) {
/* 确认已收到帧 */
$stomp->ack($frame);
}

/* 取消订阅 */
$stomp->unsubscribe($queue);

/* 关闭连接 */
unset($stomp);

?>

示例 #2 过程式风格

<?php

$queue
= '/queue/foo';
$msg = 'bar';

/* 连接 */
$link = stomp_connect('ssl://127.0.0.1:61612');

/* 检查连接 */
if (!$link) {
die(
'连接失败: ' . stomp_connect_error());
}

/* 开始事务 */
stomp_begin($link, 't1');

/* 发送消息到队列 'foo' */
stomp_send($link, $queue, $msg, array('transaction' => 't1'));

/* 提交事务 */
stomp_commit($link, 't1');

/* 订阅来自队列 'foo' 的消息 */
stomp_subscribe($link, $queue);

/* 读取帧 */
$frame = stomp_read_frame($link);

if (
$frame['body'] === $msg) {
/* 确认已收到帧 */
stomp_ack($link, $frame['headers']['message-id']);
}

/* 取消订阅 */
stomp_unsubscribe($link, $queue);

/* 关闭连接 */
stomp_close($link);

?>

注释

注意:

可以指定事务标头,指示消息确认应成为命名事务的一部分。

提示

Stomp 本质上是异步的。同步通信可以通过添加回执标头来实现。这将导致方法在服务器确认收到消息或达到读取超时之前不返回任何内容。

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top