(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
stream_set_timeout — 設定串流的逾時時間
設定 stream 的逾時值，以 seconds 和 microseconds 的總和表示。
當串流逾時時，stream_get_meta_data() 返回的陣列中的 'timed_out' 鍵會被設定為 true，但不會產生錯誤/警告。
stream目標串流。
秒數要設定的逾時秒數部分。
微秒要設定的逾時微秒部分。
範例 #1 stream_set_timeout() 範例
<?php
$fp = fsockopen("www.example.com", 80);
if (!$fp) {
echo "無法開啟\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 '連線逾時!';
} else {
echo $res;
}
}
?>注意:
此函式不適用於像 stream_socket_recvfrom() 這樣的高級操作，請改用帶有逾時參數的 stream_select()。
此函式先前稱為 set_socket_timeout()，後來稱為 socket_set_timeout()，但此用法已被棄用。
如果有人感到困惑，stream_set_timeout 不適用於使用 socket_create 或 socket_accept 建立的通訊端。請改用 socket_set_option。
取代
<?php
stream_set_timeout($socket,$sec,$usec);
?>
使用
<?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));
?>另一則註記已說明，如果對方回應非常緩慢，或者根本沒有回應，則阻塞式讀取可能會是個問題。在這種情況下，串流逾時可能無法如預期般運作。
然而，php.net 關於如何使用非阻塞式讀取操作的資訊非常少。以下是一個程式碼範例
<?php
stream_set_timeout($c, $timeout);
$data = '';
while (is_resource($c) && !feof($c)) {
// 使用非阻塞讀取第一次迴圈
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); // 注意：這可能需要調整
$str.= fgets($c, 515);
}
// 處理第一次讀取逾時
if (time() >= $endtimeOut) {
trigger_error('Timeout', E_USER_WARNING);
break;
}
stream_set_blocking($c, true);
} else {
$str = fgets($c, 515);
}
$data.= $str;
// 處理「傳統」逾時
$info = stream_get_meta_data($c);
if ($info['timed_out']) {
trigger_error('Timeout', E_USER_WARNING);
break;
}
}
?>