SAMConnection::peek
SAMConnection::receive
Fonctions SAM
PHP Manual

# SAMConnection::peekAll

(PECL sam >= 0.2.0)

SAMConnection::peekAll — Lit un ou plusieurs messages depuis la file d'attente sans les effacer

### Description

array SAMConnection::peekAll ( string `$target` [, array `$properties` ] )

### Liste de paramètres

`target`

  L'identité de la file d'attente depuis laquelle les messages doivent être lus.

`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 tableau d'objets SAMMessage ou `FALSE` si une erreur survient.

### Exemples

Exemple #1 Récupération de tous les messages d'une file d'attente sans les effacer

`<?php
$msgArray = $conn->peekAll('queue://receive/test');
if ($msgArray) {
foreach ( $msgArray as $key => $msg) {
echo "Message $key: body = $msg->body\n";
}
} else {
echo "Échec de PeekAll ($conn->errno) $conn->error";
}
?>`

Exemple #2 Récupération de tous les messages d'une file d'attente correspondant à un identifiant de corrélation

`<?php
$msgArray = $conn->peekAll('queue://receive/test', array(SAM_CORRELID => $correlId ));
if ($msgArray) {
foreach ( $msgArray as $key => $msg) {
echo "Message $key: body = $msg->body\n";
}
} else {
echo "Erreur de lecture : ($conn->errno) $conn->error";
}
?>`

### Voir aussi

- SAMConnection::peek

SAMConnection::peek
SAMConnection::receive
Fonctions SAM
PHP Manual