略微加速

PHP官方手册 - 互联网笔记

PHP - Manual: SAMConnection::peek

2024-05-03

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));

?>
add a note add a note

User Contributed Notes

There are no user contributed notes for this page.

官方地址:https://www.php.net/manual/en/samconnection.peek.php

北京半月雨文化科技有限公司.版权所有 京ICP备12026184号-3