stream_socket_shutdown(3) [php man page]

STREAM_SOCKET_SHUTDOWN(3)						 1						 STREAM_SOCKET_SHUTDOWN(3)

stream_socket_shutdown - Shutdown a full-duplex connection

SYNOPSIS

       bool stream_socket_shutdown (resource  $stream, int  $how)

DESCRIPTION

	Shutdowns (partially or not) a full-duplex connection.

PARAMETERS

	      o $stream
		- An open stream (opened with stream_socket_client(3), for example)

	      o $how
		-  One	of the following constants: STREAM_SHUT_RD (disable further receptions), STREAM_SHUT_WR (disable further transmissions) or
		STREAM_SHUT_RDWR (disable further receptions and transmissions).

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      A stream_socket_shutdown(3) example

	      <?php

	      $server = stream_socket_server('tcp://127.0.0.1:1337');
	      $client = stream_socket_client('tcp://127.0.0.1:1337');

	      var_dump(fputs($client, "hello"));

	      stream_socket_shutdown($client, STREAM_SHUT_WR);
	      var_dump(fputs($client, "hello")); // doesn't work now

	      ?>

	      The above example will output something similar to:

	      int(5)

	      Notice: fputs(): send of 5 bytes failed with errno=32 Broken pipe in test.php on line 9
	      int(0)

SEE ALSO

       fclose(3).

PHP Documentation Group 												 STREAM_SOCKET_SHUTDOWN(3)

STREAM_SOCKET_SERVER(3) 						 1						   STREAM_SOCKET_SERVER(3)

stream_socket_server - Create an Internet or Unix domain server socket

SYNOPSIS

       resource   stream_socket_server	 (string   $local_socket,  [int   &$errno],  [string   &$errstr],  [int   $flags  =  STREAM_SERVER_BIND  |
       STREAM_SERVER_LISTEN], [resource  $context])

DESCRIPTION

	Creates a stream or datagram socket on the specified $local_socket.

	This function only creates a socket, to begin accepting connections use stream_socket_accept(3).

PARAMETERS

	      o $local_socket
		- The type of socket created is determined by the transport specified using  standard  URL  formatting:  transport://target.   For
		Internet  Domain  sockets  (  AF_INET) such as TCP and UDP, the target portion of the $remote_socket parameter should consist of a
		hostname or IP address followed by a colon and a port number. For Unix domain sockets, the target  portion  should  point  to  the
		socket file on the filesystem.	Depending on the environment, Unix domain sockets may not be available. A list of available trans-
		ports can be retrieved using stream_get_transports(3). See "List of Supported Socket Transports" for a list of bulitin transports.

	      o $errno
		- If the optional $errno and $errstr arguments are present they will be set  to  indicate  the	actual	system	level  error  that
		occurred  in the system-level socket(), bind(), and listen() calls. If the value returned in $errno is 0 and the function returned
		FALSE, it is an indication that the error occurred before the bind() call. This is most likely due to a problem  initializing  the
		socket. Note that the $errno and $errstr arguments will always be passed by reference.

	      o $errstr
		- See $errno description.

	      o $flags
		- A bitmask field which may be set to any combination of socket creation flags.

	      Note

		      For UDP sockets, you must use STREAM_SERVER_BIND as the $flags parameter.

	      o $context
		-

RETURN VALUES

	Returns the created stream, or FALSE on error.

EXAMPLES

       Example #1

	      Using TCP server sockets

	      <?php
	      $socket = stream_socket_server("tcp://0.0.0.0:8000", $errno, $errstr);
	      if (!$socket) {
		echo "$errstr ($errno)<br />
";
	      } else {
		while ($conn = stream_socket_accept($socket)) {
		  fwrite($conn, 'The local time is ' . date('n/j/Y g:i a') . "
");
		  fclose($conn);
		}
		fclose($socket);
	      }
	      ?>

	The example below shows how to act as a time server which can respond to time queries as shown in an example on stream_socket_client(3).

       Note

	       Most systems require root access to create a server socket on a port below 1024.

       Example #2

	      Using UDP server sockets

	      <?php
	      $socket = stream_socket_server("udp://127.0.0.1:1113", $errno, $errstr, STREAM_SERVER_BIND);
	      if (!$socket) {
		  die("$errstr ($errno)");
	      }

	      do {
		  $pkt = stream_socket_recvfrom($socket, 1, 0, $peer);
		  echo "$peer
";
		  stream_socket_sendto($socket, date("D M j H:i:s Y
"), 0, $peer);
	      } while ($pkt !== false);

	      ?>

NOTES

       Note

	      When   specifying   a  numerical	IPv6  address  (e.g.   fe80::1),  you  must  enclose  the  IP  in  square  brackets--for  example,
	      tcp://[fe80::1]:80.

SEE ALSO 
stream_socket_client(3), stream_set_blocking(3), stream_set_timeout(3), fgets(3), fgetss(3), fwrite(3), fclose(3), feof(3),  Curl  exten-
       sion.
PHP Documentation Group 												   STREAM_SOCKET_SERVER(3)