<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<section id="filesystem.configuration">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>Filesystem and Streams Configuration Options</title>
   <tgroup cols="3">
    <thead>
     <row>
      <entry>Name</entry>
      <entry>Default</entry>
      <entry>Changeable</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>allow_url_fopen</entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
     </row>
     <row>
      <entry>user_agent</entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
     </row>
     <row>
      <entry>default_socket_timeout</entry>
      <entry>"60"</entry>
      <entry>PHP_INI_ALL</entry>
    </row>
     <row>
      <entry>from</entry>
      <entry>NULL</entry>
      <entry>??</entry>
     </row>
     <row>
      <entry>auto_detect_line_endings</entry>
      <entry>"Off"</entry>
      <entry>PHP_INI_ALL</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>
 
 &ini.descriptions.title;
 
 <para>
  <variablelist>
   <varlistentry id="ini.allow-url-fopen">
    <term>
     <parameter>allow_url_fopen</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      This option enables the URL-aware fopen wrappers that enable 
      accessing URL object like files. Default wrappers are provided for 
      the access of <link linkend="features.remote-files">remote files</link>
      using the ftp or http protocol, some extensions like
      <link linkend="ref.zlib">zlib</link> may register additional
      wrappers. 
     </para>
     <note>
      <para>
       This option was introduced immediately after the release of version 
       4.0.3. For versions up to and including 4.0.3 you can only disable this 
       feature at compile time by using the configuration switch 
       <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>
       --disable-url-fopen-wrapper</parameter></link>.
      </para>
     </note>
     <warning>
      <para> 
       On Windows versions prior to PHP 4.3.0, the following functions do not
       support remote file accessing: <function>include</function>,
       <function>include_once</function>, <function>require</function>,
       <function>require_once</function> and the imagecreatefromXXX
       functions in the <xref linkend="ref.image"/> extension.
      </para>
     </warning>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.user-agent">
    <term>
     <parameter>user_agent</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Define the user agent for <literal>PHP</literal> to send.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.default-socket-timeout">
    <term>
     <parameter>default_socket_timeout</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <para>
      Default timeout (in seconds) for socket based streams.
     </para>
     <note>
      <simpara>
       This configuration option was introduced in PHP 4.3.0
      </simpara>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.from">
    <term>
     <parameter>from="joe@example.com"</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Define the anonymous ftp password (your email address).
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.auto-detect-line-endings">
    <term>
     <parameter>auto_detect_line_endings</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      When turned on, PHP will examine the data read by
      <function>fgets</function> and <function>file</function> to see if it
      is using Unix, MS-Dos or Macintosh line-ending conventions.
     </para>
     <para>This enables PHP to interoperate with Macintosh systems,
      but defaults to Off, as there is a very small performance penalty
      when detecting the EOL conventions for the first line, and also
      because people using carriage-returns as item separators under
      Unix systems would experience non-backwards-compatible behaviour.
     </para>
     <note>
      <simpara>
       This configuration option was introduced in PHP 4.3.0
      </simpara>
     </note>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>
</section>

<!-- 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
-->