Home/ Manual/ sockets / functions/ socket_connect

socket_connect

PHP function Edit on GitHub ✎

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

Initiates a connection on a socket

Description

socket_connect(Socket $socket, string $address, int|null $port = null): bool

Initiate a connection to address using the Socket instance socket, which must be Socket instance created with socket_create().

socket: A Socket instance created with socket_create().
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.

Success 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.

Version	Description
8.0.0	`port` is nullable now.