# socket_connect

(PHP 4 >= 4.0.7, PHP 5)

socket_connect — Initiates a connection on a socket

### Description

bool socket_connect ( resource `$socket` , string `$address` [, int `$port` ] )

Initiate a connection to `address` using the socket resource `socket` , which must be a valid socket resource created with socket_create().

### Parameters

`socket`

`address`

  The `address` parameter is either an IPv4 address in dotted-quad notation (e.g. 127.0.0.1) if `socket` is `AF_INET`, a valid IPv6 address (e.g. ::1) if IPv6 support is enabled and `socket` is `AF_INET6` or the pathname of a Unix domain socket, if the socket family is `AF_UNIX`.

`port`

  The `port` parameter is only used and is mandatory when connecting to an `AF_INET` or an `AF_INET6` socket, and designates the port on the remote host to which a connection should be made.

### Return Values

Returns `TRUE` on success or `FALSE` on failure. The error code can be retrieved with socket_last_error(). This code may be passed to socket_strerror() to get a textual explanation of the error.

> Note: If the socket is non-blocking then this function returns `FALSE` with an error Operation now in progress.

### See Also

- socket_bind()
- socket_listen()
- socket_create()
- socket_last_error()
- socket_strerror()