stream_set_blocking(3) [php man page]

STREAM_SET_BLOCKING(3)							 1						    STREAM_SET_BLOCKING(3)

stream_set_blocking - Set blocking/non-blocking mode on a stream

SYNOPSIS

       bool stream_set_blocking (resource  $stream, int  $mode)

DESCRIPTION

	Sets blocking or non-blocking mode on a $stream.

	This function works for any stream that supports non-blocking mode (currently, regular files and socket streams).

PARAMETERS

	      o $stream
		- The stream.

	      o $mode
		-  If  $mode  is  0,  the given stream will be switched to non-blocking mode, and if 1, it will be switched to blocking mode. This
		affects calls like fgets(3) and fread(3) that read from the stream. In non-blocking mode an fgets(3) call will always return right
		away while in blocking mode it will wait for data to become available on the stream.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

NOTES

       Note

	       This function was previously called as set_socket_blocking(3) and later socket_set_blocking(3) but this usage is deprecated.

SEE ALSO 
stream_select(3).
PHP Documentation Group 												    STREAM_SET_BLOCKING(3)

STREAM_GET_META_DATA(3) 						 1						   STREAM_GET_META_DATA(3)

stream_get_meta_data - Retrieves header/meta data from streams/file pointers

SYNOPSIS

       array stream_get_meta_data (resource  $stream)

DESCRIPTION

	Returns information about an existing $stream.

PARAMETERS

	      o $stream
		- The stream can be any stream created by fopen(3), fsockopen(3) and pfsockopen(3).

RETURN VALUES

	The result array contains the following items:

	      o timed_out (bool) - TRUE if the stream timed out while waiting for data on the last call to fread(3) or fgets(3).

	      o blocked (bool) - TRUE if the stream is in blocking IO mode. See stream_set_blocking(3).

	      o eof  (bool)  -	TRUE  if  the  stream  has  reached  end-of-file.  Note  that for socket streams this member can be TRUE even when
		unread_bytes is non-zero. To determine if there is more data to be read, use feof(3) instead of reading this item.

	      o unread_bytes (int) - the number of bytes currently contained in the PHP's own internal buffer.

	      Note

		      You shouldn't use this value in a script.

	      o stream_type (string) - a label describing the underlying implementation of the stream.

	      o wrapper_type (string) - a label describing the protocol wrapper implementation layered over the stream. See  "Supported  Protocols
		and Wrappers" for more information about wrappers.

	      o wrapper_data  (mixed) - wrapper specific data attached to this stream. See "Supported Protocols and Wrappers" for more information
		about wrappers and their wrapper data.

	      o mode (string) - the type of access required for this stream (see Table 1 of the fopen() reference)

	      o seekable (bool) - whether the current stream can be seeked.

	      o uri (string) - the URI/filename associated with this stream.

EXAMPLES

       Example #1

	      stream_get_meta_data(3) example

	      <?php
	      $url = 'http://www.example.com/';

	      if (!$fp = fopen($url, 'r')) {
		  trigger_error("Unable to open URL ($url)", E_USER_ERROR);
	      }

	      $meta = stream_get_meta_data($fp);

	      print_r($meta);

	      fclose($fp);
	      ?>

	      The above example will output something similar to:

	      Array
	      (
		  [wrapper_data] => Array
		      (
			  [0] => HTTP/1.1 200 OK
			  [1] => Server: Apache/2.2.3 (Red Hat)
			  [2] => Last-Modified: Tue, 15 Nov 2005 13:24:10 GMT
			  [3] => ETag: "b300b4-1b6-4059a80bfd280"
			  [4] => Accept-Ranges: bytes
			  [5] => Content-Type: text/html; charset=UTF-8
			  [6] => Set-Cookie: FOO=BAR; expires=Fri, 21-Dec-2012 12:00:00 GMT; path=/; domain=.example.com
			  [6] => Connection: close
			  [7] => Date: Fri, 16 Oct 2009 12:00:00 GMT
			  [8] => Age: 1164
			  [9] => Content-Length: 438
		      )

		  [wrapper_type] => http
		  [stream_type] => tcp_socket/ssl
		  [mode] => r
		  [unread_bytes] => 438
		  [seekable] =>
		  [uri] => http://www.example.com/
		  [timed_out] =>
		  [blocked] => 1
		  [eof] =>
	      )

NOTES

       Note

	      This function does NOT work on sockets created by the Socket extension.

SEE ALSO

       get_headers(3), $http_response_header.

PHP Documentation Group 												   STREAM_GET_META_DATA(3)