EventBufferEvent::connectHost

    (PECL event >= 1.2.6-beta)

    EventBufferEvent::connectHost — Connects to a hostname with optionally asyncronous DNS resolving

    Description

    publicEventBufferEvent::connectHost(
        EventDnsBase$dns_base,
        string$hostname,
        int$port,
        int$family = EventUtil::AF_UNSPEC
    ): bool

    Resolves the DNS name hostname, looking for addresses of type family ( EventUtil::AF_* constants). If the name resolution fails, it invokes the event callback with an error event. If it succeeds, it launches a connection attempt just as EventBufferEvent::connect() would.

    dns_base is optional. May be null, or an object created with EventDnsBase::__construct() . For asyncronous hostname resolving pass a valid event dns base resource. Otherwise the hostname resolving will block.

    Note:

    EventDnsBase is available only if Event configured --with-event-extra ( event_extra library, libevent protocol-specific functionality support including HTTP, DNS, and RPC ).

    Note:

    EventBufferEvent::connectHost() requires libevent-2.0.3-alpha or greater.

    Parameters

    dns_base

    Object of EventDnsBase in case if DNS is to be resolved asyncronously. Otherwise null.

    hostname

    Hostname to connect to. Recognized formats are: 

    www.example.com (hostname) 1.2.3.4 (ipv4address) ::1 (ipv6address) [::1] ([ipv6address])
    port

    Port number

    family

    Address family. EventUtil::AF_UNSPEC , EventUtil::AF_INET , or EventUtil::AF_INET6 . See EventUtil constants .

    Return Values

    Returns true on success or false on failure.

    Examples

    Example #1 EventBufferEvent::connectHost() example

    <?php

    function readcb($bev, $base) {
    //$input = $bev->input;

    The above example will output something similar to:

    Connected. HTTP/1.0 301 Moved Permanently Location: http://www.google.co.uk/ Content-Type: text/html; charset=UTF-8 Date: Sat, 09 Mar 2013 12:21:19 GMT Expires: Mon, 08 Apr 2013 12:21:19 GMT Cache-Control: public, max-age=2592000 Server: gws Content-Length: 221 X-XSS-Protection: 1; mode=block X-Frame-Options: SAMEORIGIN <HTML><HEAD><meta http-equiv="content-type" content="text/html;charset=utf-8"> <TITLE>301 Moved</TITLE></HEAD><BODY> <H1>301 Moved</H1> The document has moved <A HREF="http://www.google.co.uk/">here</A>. </BODY></HTML> Closing Done

    See Also

    To Top