socket_connect(3) [php man page]

SOCKET_CONNECT(3)							 1							 SOCKET_CONNECT(3)

socket_connect - Initiates a connection on a socket

SYNOPSIS

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

DESCRIPTION

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

PARAMETERS

	      o $socket
		-

	      o $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 fam-
		ily is AF_UNIX.

	      o $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(3).  This  code  may  be	passed	to
       socket_strerror(3) 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(3), socket_listen(3), socket_create(3), socket_last_error(3), socket_strerror(3).

PHP Documentation Group 													 SOCKET_CONNECT(3)

SOCKET_STRERROR(3)							 1							SOCKET_STRERROR(3)

socket_strerror - Return a string describing a socket error

SYNOPSIS

       string socket_strerror (int  $errno)

DESCRIPTION

       socket_strerror(3)  takes  as  its  $errno  parameter a socket error code as returned by socket_last_error(3) and returns the corresponding
       explanatory text.

       Note

	       Although the error messages generated by the socket extension are in English, the system messages retrieved with this function will
	      appear depending on the current locale ( LC_MESSAGES).

PARAMETERS

	      o $errno
		- A valid socket error number, likely produced by socket_last_error(3).

RETURN VALUES

	Returns the error message associated with the $errno parameter.

EXAMPLES

       Example #1

	      socket_strerror(3) example

	      <?php
	      if (false == ($socket = @socket_create(AF_INET, SOCK_STREAM, SOL_TCP))) {
		 echo "socket_create() failed: reason: " . socket_strerror(socket_last_error()) . "
";
	      }

	      if (false == (@socket_bind($socket, '127.0.0.1', 80))) {
		 echo "socket_bind() failed: reason: " . socket_strerror(socket_last_error($socket)) . "
";
	      }
	      ?>

	       The expected output from the above example (assuming the script is not run with root privileges):

	      socket_bind() failed: reason: Permission denied

SEE ALSO

       socket_accept(3), socket_bind(3), socket_connect(3), socket_listen(3), socket_create(3).

PHP Documentation Group 													SOCKET_STRERROR(3)