HTTP_THROTTLE(3)							 1							  HTTP_THROTTLE(3)

http_throttle - HTTP throttling

SYNOPSIS

       void http_throttle (float  $sec, [int  $bytes = 40960])

DESCRIPTION

	Sets the throttle delay and send buffer size.

       Note

	      This function should be used in conjunction with http_send_data(3), http_send_file(3) and http_send_stream(3).

       Note

	      Provides a basic throttling mechanism, which will yield the current process or thread until the entity has been completely sent.

       Note

	       This may not work as expected with the following SAPI(s): FastCGI.

PARAMETERS

	      o $sec
		- seconds to sleep after each chunk sent

	      o $bytes
		- the chunk size in bytes

EXAMPLES

       Example #1

	      A http_throttle(3) example

	       Send file with approximately 20 kbyte/s.

	      <?php
	      // ~ 20 kbyte/s
	      # http_throttle(1, 20000);
	      # http_throttle(0.5, 10000);
	      http_throttle(0.1, 2000);
	      http_send_file('document.pdf');
	      ?>

SEE ALSO

       http_send_data(3), http_send_file(3), http_send_stream(3), the HttpResponse class if you are using PHP 5.1.0 and above.

PHP Documentation Group 													  HTTP_THROTTLE(3)