php man page for socket_bind

SOCKET_BIND(3)								 1							    SOCKET_BIND(3)

socket_bind - Binds a name to a socket

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

DESCRIPTION
	Binds  the  name  given  in  $address  to the socket described by $socket. This has to be done before a connection is be established using
       socket_connect(3) or socket_listen(3).

PARAMETERS
	      o $socket
		- A valid socket resource created with socket_create(3).

	      o $address
		- If the socket is of the AF_INET family, the $address is an IP in dotted-quad notation (e.g.  127.0.0.1).  If the  socket  is	of
		the AF_UNIX family, the $address is the path of a Unix-domain socket (e.g.  /tmp/my.sock).

	      o $port (Optional)
		- The $port parameter is only used when binding an AF_INET socket, and designates the port on which to listen for connections.

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.

EXAMPLES
       Example #1

	      Using socket_bind(3) to set the source address

	      <?php
	      // Create a new socket
	      $sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

	      // An example list of IP addresses owned by the computer
	      $sourceips['kevin']    = '127.0.0.1';
	      $sourceips['madcoder'] = '127.0.0.2';

	      // Bind the source address
	      socket_bind($sock, $sourceips['madcoder']);

	      // Connect to destination address
	      socket_connect($sock, '127.0.0.1', 80);

	      // Write
	      $request = 'GET / HTTP/1.1' . "
" .
			 'Host: example.com' . "

";
	      socket_write($sock, $request);

	      // Close
	      socket_close($sock);

	      ?>

NOTES
       Note

	       This function must be used on the socket before socket_connect(3).

       Note

	       Windows 9x/ME compatibility note: socket_last_error(3) may return an invalid error code if trying to bind the  socket  to  a  wrong
	      address that does not belong to your machine.

SEE ALSO
       socket_connect(3), socket_listen(3), socket_create(3), socket_last_error(3), socket_strerror(3).

PHP Documentation Group 													    SOCKET_BIND(3)