<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/filesystem.setup.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'en',
  ),
  'this' => 
  array (
    0 => 'filesystem.configuration.php',
    1 => 'Runtime Configuration',
    2 => 'Runtime Configuration',
  ),
  'up' => 
  array (
    0 => 'filesystem.setup.php',
    1 => 'Installing/Configuring',
  ),
  'prev' => 
  array (
    0 => 'filesystem.setup.php',
    1 => 'Installing/Configuring',
  ),
  'next' => 
  array (
    0 => 'filesystem.resources.php',
    1 => 'Resource Types',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/filesystem/ini.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<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.php#ini.allow-url-fopen" class="link">allow_url_fopen</a></td>
      <td>&quot;1&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-system">INI_SYSTEM</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.php#ini.allow-url-include" class="link">allow_url_include</a></td>
      <td>&quot;0&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-system">INI_SYSTEM</a></code></strong></td>
      <td>Deprecated as of PHP 7.4.0.</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.php#ini.user-agent" class="link">user_agent</a></td>
      <td>NULL</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.php#ini.default-socket-timeout" class="link">default_socket_timeout</a></td>
      <td>&quot;60&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td class="empty">&nbsp;</td>
    </tr>

     <tr>
      <td><a href="filesystem.configuration.php#ini.from" class="link">from</a></td>
      <td>&quot;&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.php#ini.auto-detect-line-endings" class="link">auto_detect_line_endings</a></td>
      <td>&quot;0&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Deprecated as of PHP 8.1.0.</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.php#ini.sys-temp-dir" class="link">sys_temp_dir</a></td>
      <td>&quot;&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-system">INI_SYSTEM</a></code></strong></td>
      <td class="empty">&nbsp;</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.php" class="type bool">bool</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.php" class="link">remote files</a>
      using the ftp or http protocol, some extensions like
      <a href="ref.zlib.php" class="link">zlib</a> may register additional
      wrappers. 
     </p>
    </dd>
   

   
    <dt id="ini.allow-url-include">
     <code class="parameter">allow_url_include</code>
     <span class="type"><a href="language.types.boolean.php" class="type bool">bool</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.php" class="function">include</a></span>, <span class="function"><a href="function.include-once.php" class="function">include_once</a></span>, 
      <span class="function"><a href="function.require.php" class="function">require</a></span>, <span class="function"><a href="function.require-once.php" 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.php" 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.php" class="type int">int</a></span>
    </dt>
    <dd>
     <p class="para">
      Default timeout (in seconds) for socket based streams.
      Specifying a negative value means an infinite timeout.
     </p>
    </dd>
   

   
    <dt id="ini.from">
     <code class="parameter">from</code>
     <span class="type"><a href="language.types.string.php" 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.php" class="type bool">bool</a></span>
    </dt>
    <dd>
     <p class="para">
      When turned on, PHP will examine the data read by
      <span class="function"><a href="function.fgets.php" class="function">fgets()</a></span> and <span class="function"><a href="function.file.php" 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>
    </dd>
   
   
   
    <dt id="ini.sys-temp-dir">
     <code class="parameter">sys_temp_dir</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <p class="para">
     </p>
    </dd>
   

  </dl>
 </p>
</div><?php manual_footer($setup); ?>