(PECL sam >= 0.1.0)
SAMConnection::peek — Lit un message depuis la file d'attente sans l'effacer
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. |
Cette méthode retourne un objet SAMMessage ou FALSE si une erreur survient.
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));
?>