PHP Manual
SAM 函数
Read a message from a queue without removing it from the queue

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

php gettext 函数 specify the character encoding in which the messages from the domain message catalog will be returned php cubrid 过时的别名和函数 read data from a glo instance and save it in a file php cubrid 过时的别名和函数 read data from glo and send it to std output php fdf 函数 read a fdf document from a string php imap 函数 read the structure of a specified body section of a specific message php mailparse 函数 extracts a message section including headers without decoding the transfer encoding php semaphore 函数 receive a message from a message queue php semaphore 函数 returns information from the message queue data structure php ncurses 函数 remove panel from the stack making it invisible php shared memory 函数 read data from shared memory block php socket 函数 sends a message to a socket whether it is connected or not php sybase 函数 returns the last message from the server php sam 函数 read a message from a queue without removing it from the queue php sam 函数 read one or more messages from a queue without removing it from the queue php sam 函数 receive a message from a queue or subscription php sam 函数 remove a message from a queue php sam 函数 send a message to a queue or publish an item to a topic php sam 函数 the body of the message php sdo das xml 函数 creates an xml document object from scratch without the need to load a document from a file or string php swoole process read and pop data from the message queue.