SAMConnection::peek
(PECL sam >= 0.1.0)
SAMConnection::peek — Lit un message depuis la file d'attente sans l'effacer
Description
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
Exemple #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";
}
?>
Exemple #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));
?>