PHP Velho Oeste 2024

SAMConnection::peek

(PECL sam >= 0.1.0)

SAMConnection::peek Lit un message depuis la file d'attente sans l'effacer

Description

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

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

?>

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top