<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>Runtime Configuration</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="filesystem.installation.html">Installation</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="filesystem.resources.html">Resource Types</a></div>
 <div class="up"><a href="filesystem.setup.html">Installing/Configuring</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="filesystem.configuration" class="section">
 <h2 class="title">Runtime Configuration</h2>
 <p class="simpara">
The behaviour of these functions is affected by settings in <var class="filename">php.ini</var>.
</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>Filesystem and Streams Configuration Options</strong></caption>
   
    <thead>
     <tr>
      <th>Name</th>
      <th>Default</th>
      <th>Changeable</th>
      <th>Changelog</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><a href="filesystem.configuration.html#ini.allow-url-fopen" class="link">allow_url_fopen</a></td>
      <td>&quot;1&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td>PHP_INI_ALL in PHP &lt;= 4.3.4. Available since PHP 4.0.4.</td>
      
     </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.allow-url-include" class="link">allow_url_include</a></td>
      <td>&quot;0&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td>Available since PHP 5.2.0.</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.user-agent" class="link">user_agent</a></td>
      <td>NULL</td>
      <td>PHP_INI_ALL</td>
      <td>Available since PHP 4.3.0.</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.default-socket-timeout" class="link">default_socket_timeout</a></td>
      <td>&quot;60&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>Available since PHP 4.3.0.</td>
    </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.from" class="link">from</a></td>
      <td>&quot;&quot;</td>
      <td>PHP_INI_ALL</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.auto-detect-line-endings" class="link">auto_detect_line_endings</a></td>
      <td>&quot;0&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>Available since PHP 4.3.0.</td>
     </tr>

    </tbody>
   
  </table>

 </p>
 
 <p class="para">Here&#039;s a short explanation of
the configuration directives.</p>
 
 <p class="para">
  <dl>

   
    <dt id="ini.allow-url-fopen">
     <code class="parameter">allow_url_fopen</code>
     <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
    </dt>

    <dd>

     <p class="para">
      This option enables the URL-aware fopen wrappers that enable 
      accessing URL object like files. Default wrappers are provided for 
      the access of <a href="features.remote-files.html" class="link">remote files</a>
      using the ftp or http protocol, some extensions like
      <a href="ref.zlib.html" class="link">zlib</a> may register additional
      wrappers. 
     </p>
     <blockquote class="note"><p><strong class="note">Note</strong>: 
      <p class="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 
       <a href="configure.about.html#configure.disable-url-fopen-wrapper" class="link"><code class="parameter">
       --disable-url-fopen-wrapper</code></a>.
      </p>
     </p></blockquote>
     <div class="warning"><strong class="warning">Warning</strong>
      <p class="para"> 
       On Windows versions prior to PHP 4.3.0, the following functions do not
       support remote file accessing: <span class="function"><a href="function.include.html" class="function">include</a></span>,
       <span class="function"><a href="function.include-once.html" class="function">include_once</a></span>, <span class="function"><a href="function.require.html" class="function">require</a></span>,
       <span class="function"><a href="function.require-once.html" class="function">require_once</a></span> and the imagecreatefromXXX
       functions in the <a href="ref.image.html" class="xref">GD and Image Functions</a> extension.
      </p>
     </div>
    </dd>

   

   
    <dt id="ini.allow-url-include">
     <code class="parameter">allow_url_include</code>
     <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
    </dt>

    <dd>

     <p class="para">
      This option allows the use of URL-aware fopen wrappers with the following 
      functions: <span class="function"><a href="function.include.html" class="function">include</a></span>, <span class="function"><a href="function.include-once.html" class="function">include_once</a></span>, 
      <span class="function"><a href="function.require.html" class="function">require</a></span>, <span class="function"><a href="function.require-once.html" class="function">require_once</a></span>.
     </p>
     <blockquote class="note"><p><strong class="note">Note</strong>: 
      <p class="para">
       This setting requires allow_url_fopen to be on. 
      </p>
     </p></blockquote>
    </dd>

   

   
    <dt id="ini.user-agent">
     <code class="parameter">user_agent</code>
     <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
    </dt>

    <dd>

     <p class="para">
      Define the user agent for PHP to send.
     </p>
    </dd>

   

   
    <dt id="ini.default-socket-timeout">
     <code class="parameter">default_socket_timeout</code>
     <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
    </dt>

    <dd>

     <p class="para">
      Default timeout (in seconds) for socket based streams.
     </p>
     <blockquote class="note"><p><strong class="note">Note</strong>: 
      <span class="simpara">
       This configuration option was introduced in PHP 4.3.0
      </span>
     </p></blockquote>
    </dd>

   

   
    <dt id="ini.from">
     <code class="parameter">from</code>
     <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
    </dt>

    <dd>

     <p class="para">
      The email address to be used on unauthenticated FTP connections and
      as the value of From header for HTTP connections, when using the ftp
      and http wrappers, respectively.
     </p>
    </dd>

   

   
    <dt id="ini.auto-detect-line-endings">
     <code class="parameter">auto_detect_line_endings</code>
     <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
    </dt>

    <dd>

     <p class="para">
      When turned on, PHP will examine the data read by
      <span class="function"><a href="function.fgets.html" class="function">fgets()</a></span> and <span class="function"><a href="function.file.html" class="function">file()</a></span> to see if it
      is using Unix, MS-Dos or Macintosh line-ending conventions.
     </p>
     <p class="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.
     </p>
     <blockquote class="note"><p><strong class="note">Note</strong>: 
      <span class="simpara">
       This configuration option was introduced in PHP 4.3.0
      </span>
     </p></blockquote>
    </dd>

   
  </dl>

 </p>
</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="filesystem.installation.html">Installation</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="filesystem.resources.html">Resource Types</a></div>
 <div class="up"><a href="filesystem.setup.html">Installing/Configuring</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
