PHP 8.5.0 Alpha 1 available for testing

stream_set_timeout

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

stream_set_timeoutConfigura el tiempo de espera de un flujo

Descripción

stream_set_timeout(resource $stream, int $seconds, int $microseconds = 0): bool

stream_set_timeout() configura el tiempo de espera del flujo stream, expresado como la duración de seconds segundos y microseconds microsegundos.

Cuando el flujo se agota, la clave 'timed_out' del array devuelto por stream_get_meta_data() se establece a true, sin embargo, no se genera ningún error o alerta.

Parámetros

stream

El flujo objetivo.

seconds

El número de segundos enteros del tiempo de espera.

microseconds

El número de microsegundos enteros del tiempo de espera.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo con stream_set_timeout()

<?php
$fp
= fsockopen("www.example.com", 80);
if (!
$fp) {
echo
"No se puede abrir\n";
} else {

fwrite($fp, "GET / HTTP/1.0\r\n\r\n");
stream_set_timeout($fp, 2);
$res = fread($fp, 2000);

$info = stream_get_meta_data($fp);
fclose($fp);

if (
$info['timed_out']) {
echo
'¡Tiempo de conexión agotado!';
} else {
echo
$res;
}

}
?>

Notas

Nota:

Esta función no funciona con operaciones avanzadas como stream_socket_recvfrom(), utilice en su lugar stream_select() con un tiempo de espera como parámetro.

Esta función se llamaba anteriormente set_socket_timeout(), y también socket_set_timeout(), pero estos nombres están obsoletos.

Ver también

  • fsockopen() - Abre un socket de conexión Internet o Unix
  • fopen() - Abre un fichero o un URL
add a note

User Contributed Notes 4 notes

up
25
hamishcool3 at yahoo dot co dot uk
14 years ago
In case anyone is puzzled, stream_set_timeout DOES NOT work for sockets created with socket_create or socket_accept. Use socket_set_option instead.

Instead of:
<?php
stream_set_timeout
($socket,$sec,$usec);
?>

Use:
<?php
socket_set_option
($socket, SOL_SOCKET, SO_RCVTIMEO, array('sec'=>$sec, 'usec'=>$usec));
socket_set_option($socket, SOL_SOCKET, SO_SNDTIMEO, array('sec'=>$sec, 'usec'=>$usec));
?>
up
1
burninleo at gmx dot net
9 years ago
Another note alread states that blocking-reads may be an issue, if the counterpart responds very slowly - or not at all. The stream timeout may not work as expected in such a situation.

However, php.net provides very little information on how to use non-blocking reading operations. Here's a code sample:

<?php
stream_set_timeout
($c, $timeout);
$data = '';
while (
is_resource($c) && !feof($c)) {
// Use non-blocking reading for first loop
if (($data === '') and ($timeout > 0)) {
stream_set_blocking($c, false);
$endtimeOut = time() + $timeout;
$str = '';
while ((
time() < $endtimeOut) and (strlen($str) < 515) and !feof($c)) {
sleep(1); // Note: This may require tuning
$str.= fgets($c, 515);
}
// Handling first-read timeout
if (time() >= $endtimeOut) {
trigger_error('Timeout', E_USER_WARNING);
break;
}
stream_set_blocking($c, true);
} else {
$str = fgets($c, 515);
}
$data.= $str;

// Handling of "traditional" timeout
$info = stream_get_meta_data($c);
if (
$info['timed_out']) {
trigger_error('Timeout', E_USER_WARNING);
break;
}
}
?>
up
1
emailfire at gmail dot com
14 years ago
This function seems to have no effect when running as a CLI script, see http://bugs.php.net/bug.php?id=36030
up
1
ridera
20 years ago
I have found it required to add

"stream_set_blocking($fp, FALSE )"

prior to any fgets(), fread(), etc. to prevent the code from hanging up when remote files are called and the response is slow.
To Top