<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<!-- splitted from ./en/functions/network.xml, last change in rev 1.18 -->
  <refentry id="function.stream-set-timeout">
   <refnamediv>
    <refname>stream_set_timeout</refname>
    <refpurpose>Set timeout period on a stream</refpurpose> 
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>bool</type><methodname>stream_set_timeout</methodname>
      <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
      <methodparam><type>int</type><parameter>seconds</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>microseconds</parameter></methodparam>
     </methodsynopsis>
    <para>
     Sets the timeout value on <parameter>stream</parameter>,
     expressed in the sum of <parameter>seconds</parameter> and
     <parameter>microseconds</parameter>. &return.success;
    </para>
    <para>
     When the stream times out, the 'timed_out' key of the array returned by
     <function>stream_get_meta_data</function> is set to &true;, although no
     error/warning is generated.
    </para>
    <para>
     <example>
      <title><function>stream_set_timeout</function> example</title>
       <programlisting role="php">
<![CDATA[
<?php
$fp = fsockopen("www.example.com", 80);
if (!$fp) {
    echo "Unable to open\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 'Connection timed out!';
    } else {
        echo $res;
    }

}
?>
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <simpara>
      As of PHP 4.3, this function can (potentially) work on any kind of
      stream.  In PHP 4.3, socket based streams are still the only kind
      supported in the PHP core, although streams from other extensions
      may support this function.
     </simpara>
    </note>
    <note>
     <para>
      This function doesn't work with advanced operations like
      <function>stream_socket_recvfrom</function>, use
      <function>stream_select</function> with timeout parameter instead.
     </para>
    </note>
    <para>
     This function was previously called as
     <function>set_socket_timeout</function> and later
     <function>socket_set_timeout</function> but this usage is deprecated.
    </para>
    <para>
     See also
     <function>fsockopen</function> and
     <function>fopen</function>.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->