ZMQContext::getSocket

    (PECL zmq >= 0.5.0)

    ZMQContext::getSocket — Create a new socket

    Description

    publicZMQContext::getSocket(int$type, string$persistent_id = null, callable$on_new_socket = null): ZMQSocket

    Shortcut for creating new sockets from the context. If the context is not persistent the persistent_id parameter is ignored and the socket falls back to being non-persistent. The on_new_socket is called only when a new underlying socket structure is created.

    Parameters

    type

    ZMQ::SOCKET_* constant to specify socket type.

    persistent_id

    If persistent_id is specified the socket will be persisted over multiple requests.

    on_new_socket

    Callback function, which is executed when a new socket structure is created. This function does not get invoked if the underlying persistent connection is re-used. The callback takes ZMQSocket and persistent_id as two arguments.

    Return Values

    Returns a ZMQSocket object.

    Errors/Exceptions

    Throws ZMQSocketException on error.

    Examples

    Example #1 A ZMQContext() example

    Basic usage

    <?php

    $context = new ZMQContext();


    $socket = $context->getSocket(ZMQ::SOCKET_REQ, 'my sock');


    $socket->connect("tcp://example.com:1234");


    $socket->send("Hello there");


    $message = $socket->recv();
    echo     "Received message: {$message}\n";
    ?>
    To Top