SAMConnection::receive
(PECL sam >= 0.1.0)
SAMConnection::receive — Reçoit un message depuis une file d'attente ou d'une souscription
Description
Liste de paramètres
-
target
-
L'identité de la file d'attente, du sujet ou de la souscription depuis lequel le message est reçu.
-
properties
-
Un tableau associatif optionnel de propriétés décrivant les autres paramètres pour contrôler l'opération de réception :
Nom de la propriété Valeurs possibles SAM_CORRELID Utilisé pour demander la réception d'un message en se basant sur l'identifiant de corrélation du message. SAM_MESSAGEID Utilisé pour demander la réception d'un message en se basant sur l'identifiant du message. SAM_WAIT Délai d'attente maximal en millisecondes permettant de contrôler le temps d'attente de réception du message avant de retourner une erreur si aucun message n'est disponible sur la file d'attente ou sur le sujet. La valeur par défaut est 0, ce qui signifie que le délai est infini et doit donc être utilisée avec précaution car la demande attendra jusqu'au temps limite d'exécution PHP si aucun message n'est disponible.
Exemples
Exemple #1 Réception d'un message depuis la file d'attente
<?php
$msg = $conn->receive('queue://receive/test');
if (!$msg) {
// La réception a échoué !
echo "La réception a échoué : ($conn->errno) $conn->error";
}
?>
Exemple #2 Réception d'un message depuis la file d'attente avec des options
Dans cet exemple, l'option SAM_CORRELID est utilisé pour spécifier un identifiant de corrélation à utiliser pour identifier le message à recevoir ainsi qu'un délai d'attente maximal de 10 secondes.
<?php
$msg = $conn->receive('queue://receive/test', array(SAM_CORRELID => $token, SAM_WAIT => 10000));
?>
Exemple #3 Réception d'un message depuis une souscription
Dans cet exemple, nous montrons comment réceptionner un message depuis un identifiant de souscription.
<?php
$msg = $conn->receive($subscriptionName);
if (!$msg) {
// La réception a échoué !
echo "La réception a échoué : ($conn->errno) $conn->error";
}
?>
Noter que $subscriptionName est un identifiant de souscription retourné lors d'un précédent appel à une souscription.
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-samconnection.receive.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.