PHP Doku:: Read a message from a queue without removing it from the queue. - function.samconnection-peek.html

Verlauf / Chronik / History: (14) anzeigen

Sie sind hier:
Doku-StartseitePHP-HandbuchFunktionsreferenzSonstige DiensteSimple Asynchronous MessagingSAM FunktionenSAMConnection->peek

Ein Service von Reinhard Neidl - Webprogrammierung.

SAM Funktionen

<<SAMConnection->isConnected

SAMConnection->peekAll>>

SAMConnection->peek

(PECL sam >= 0.1.0)

SAMConnection->peek Read a message from a queue without removing it from the queue.

Beschreibung

SAMMessage SAMConnection::peek ( string $target [, array $properties ] )

Parameter-Liste

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.

Rückgabewerte

This method returns a SAMMessage object or FALSE if an error occurs.

Beispiele

Beispiel #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";
}
?>

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

?>


Keine BenutzerBeiträge.
- Beiträge aktualisieren...



PHP Powered Diese Seite bei php.net
The PHP manual text and comments are covered by the Creative Commons Attribution 3.0 License © the PHP Documentation Group - Impressum - mail("TO:Reinhard Neidl",...)