- PHP 手册
- 函数参考
- 其它服务
- SAM
- SAM 函数
SAMConnection::peek
(PECL sam >= 0.1.0)
SAMConnection::peek — Read a message from a queue without removing it from the queue
说明
SAMConnection::peek ( string$target
[, array $properties
] ) : SAMMessage
参数
-
target -
The identity of the queue from which to peek the message.
-
properties -
An optional associative array of properties describing other parameters to control the peek operation.
Property name Possible values SAM_CORRELID This is the target correlation id string of the message. This would typically have been returned by a "send" request. SAM_MESSAGEID This is the message id string of the message which is to be peeked.
返回值
This method returns a SAMMessage object or FALSE if an error occurs.
范例
Example #1 Retrieve the next message from a queue without removing it
<?php
$msg = $conn->peek('queue://receive/test');
if (!$msg) {
// The peek failed!
echo "Peek failed ($conn->errno) $conn->error";
}
?>
Example #2 Retrieve a specific message from a queue without removing it from the queue
<?php
$msg = $conn->peek('queue://receive/test', array(SAM_MESSAGEID => $messageId));
?>
参见
- SAMConnection::peekAll
User Contributed Notes
There are no user contributed notes for this page.官方地址：https://www.php.net/manual/en/samconnection.peek.php