From b4ceb970a7698a8290c4b4ff72dcd6ccad484d83 Mon Sep 17 00:00:00 2001
From: Kalle Sommer Nielsen <kalle@php.net>
Date: Sun, 10 Jan 2010 23:38:48 +0000
Subject: [PATCH] Fixed bug #43782 (feof() does not detect timeout on socket)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@293364 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/filesystem/functions/feof.xml | 30 +++++++++++++++++++++----
 1 file changed, 26 insertions(+), 4 deletions(-)

diff --git a/reference/filesystem/functions/feof.xml b/reference/filesystem/functions/feof.xml
index 9088787fd9..cb5f0fae64 100644
--- a/reference/filesystem/functions/feof.xml
+++ b/reference/filesystem/functions/feof.xml
@@ -44,10 +44,32 @@
   <warning>
    <simpara>
     If a connection opened by <function>fsockopen</function> wasn't closed
-    by the server, <function>feof</function> will wait until a timeout has
-    been reached to return &true;. The default timeout value is 60 seconds.
-    You may use <function>stream_set_timeout</function> to change this
-    value.
+    by the server, <function>feof</function> will hang. To workaround this, see 
+    below example:
+    <example>
+     <title>Handling timeouts with <function>feof</function></title>
+     <programlisting role="php">
+ <![CDATA[
+<?php
+function safe_feof($fp, &start = NULL) {
+	$start = microtime(true);
+
+	return feof($fp);
+}
+
+/* Assuming $fp is previously opened by fsockopen() */
+
+$start = NULL;
+$timeout = ini_get('default_socket_timeout');
+
+while(!safe_feof($fp, $start) && (microtime(true) - $start) < $timeout)
+{
+	/* Handle */
+}
+?>
+]]>
+     </programlisting>
+    </example>
    </simpara>
   </warning>
   <warning>