SAMConnection::peek

(PECL sam >= 0.1.0)

SAMConnection::peek Lectura de un mensaje de una cola sin eliminarlo de la cola.

Descripción

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

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

?>

Ver también