SAMConnection::peek
(PECL sam >= 0.1.0)
SAMConnection::peek — Lectura de un mensaje de una cola sin eliminarlo de la cola.
Descripción
Parámetros
-
target -
La identidad de la cola de la cual se va a leer el mensaje.
-
properties -
Un array asociativo opcional de propiedades, que describen otros parámetros para controlar la operación de lectura.
Nombre de la propiedad Valores posibles SAM_CORRELID Este es el identificador de correlación del mensaje. Es retornado típicamente por una petición "send". SAM_MESSAGEID Este es el identificador del mensaje que va a ser leído.
Valores devueltos
Este método devuelve un objeto SAMMessage o FALSE en caso de error.
Ejemplos
Ejemplo #1 Obtener el próximo mensaje de una cola sin eliminarlo de la cola
<?php
$msg = $conn->peek('queue://receive/test');
if (!$msg) {
// The peek failed!
echo "Peek failed ($conn->errno) $conn->error";
}
?>
Ejemplo #2 Obtener un mensaje específico de la cola sin eliminarlo de la cola
<?php
$msg = $conn->peek('queue://receive/test', array(SAM_MESSAGEID => $messageId));
?>
add a note
User Contributed Notes
There are no user contributed notes for this page.
