SAMConnection::isConnected
SAMConnection::peekAll
Fonctions SAM
PHP Manual

# SAMConnection::peek

(PECL sam >= 0.1.0)

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

### Description

SAMMessage SAMConnection::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

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

### Voir aussi

- SAMConnection::peekAll

SAMConnection::isConnected
SAMConnection::peekAll
Fonctions SAM
PHP Manual