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