Forum und email

SAMConnection->peek()

(No version information available, might be only in CVS)

SAMConnection->peek() — Lit un message depuis la file d'attente sans l'effacer

Description

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

Liste de paramètres

target

L'identité de la file d'attente depuis laquelle on lit le message.

properties

Un tableau associatif optionnel de propriétés décrivant les autres paramètres pour contrôler l'opération.

Nom de la propriété Valeurs possibles
SAM_CORRELID C'est l'identifiant de corrélation des messages à lire. Ceci est typiquement retourné par la demande "send".
SAM_MESSAGEID C'est l'identifiant du message à lire.

Valeurs de retour

Cette méthode retourne un objet SAMMessage ou FALSE si une erreur survient.

Exemples

Example#1 Récupération du prochain message depuis la file d'attente sans l'effacer

<?php
$msg 
$conn->peek('queue://receive/test');

if (!
$msg) {
  
// Échec de la lecture !
  
echo "Échec de la lecture : ($conn->errno) $conn->error";
}
?>

Example#2 Récupération d'un message spécifique depuis la file d'attente sans l'effacer

<?php
$msg 
$conn->peek('queue://receive/test', array(SAM_MESSAGEID => $messageId));
?>