ZMQSocket::recv

(PECL zmq >= 0.5.0)

ZMQSocket::recv — Recoit un message

Description

public ZMQSocket::recv(int $mode = 0): string

Recoit un message du socket. Par défaut, la réception va être bloquante tant qu'un message est disponible, à moins que ZMQ::MODE_DONTWAIT ne soit utilisé. L'option ZMQ::SOCKOPT_RCVMORE du socket peut être utilisée pour recevoir des messages multipart. Voir ZMQSocket::setSockOpt() pour plus d'informations.

Liste de paramètres

mode: Drapeaux de mode pour recevoir les messages multipart, ou rendre l'opération non-bloquante. Voir les constantes ZMQ::MODE_*.

Valeurs de retour

Retourne le message. Si ZMQ::MODE_DONTWAIT est utilisé et que l'opération bloquerait false devrait être retourné.

Erreurs / Exceptions

Lance une ZMQSocketException en cas d'erreur.

Exemples

Exemple #1 Un exemple d'envoi/réception

Envoi et réception non bloquante


<?php

/* Crée un nouvel objet de file ; il doit y avoir un serveur de l'autre côté */
$queue = new ZMQSocket(new ZMQContext(), ZMQ::SOCKET_REQ);
$queue->connect("tcp://127.0.0.1:5555");

/* Assigne le socket 1 à la file, envoi et réceptionne */
$retries = 5;
$sending = true;

/* Démarre la boucle */
do {
    try {
        /* Tente un envoi/réception */
        if ($sending) {
            echo "Envoi du message\n";
            $queue->send("Ceci est un message", ZMQ::MODE_DONTWAIT);
            $sending = false;
        } else {
            echo "Réception de la réponse : " . $queue->recv(ZMQ::MODE_DONTWAIT) . "\n";
            break;
        }
    } catch (ZMQSocketException $e) {
        /* EAGAIN signifie que l'opération a bloqué ; nouvelle tentative */
        if ($e->getCode() === ZMQ::ERR_EAGAIN) {
            echo " - Réception de EAGAIN, nouvelle tentative ($retries)\n";
        } else {
            die(" - Erreur : " . $e->getMessage());
        }
    }
    /* On attend un peu entre les opérations */
    usleep(5);
} while (--$retries);
?>

Résultat de l'exemple ci-dessus est similaire à :

Envoi du message
 - Unable to execute operation, retrying (4)
Réception de la réponse : Ceci est un message