# http_throttle

(PECL pecl_http:0.10.0-1.5.5)

http_throttle — HTTP throttling

### Description

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

Sets the throttle delay and send buffer size.

> Note: This function is supposed to be used in conjunction with http_send_data(), http_send_file() and http_send_stream().

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

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

### Parameters

`sec`

  seconds to sleep after each chunk sent

`bytes`

  the chunk size in bytes

### Examples

Example#1 A http_throttle() 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()
- http_send_file()
- http_send_stream()
- the HttpResponse class if you are using PHP-5.1 and above