Source of: /manual/en/filesystem.configuration.php
<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = 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',
),
'up' =>
array (
0 => 'filesystem.setup.php',
1 => 'Installing/Configuring',
),
'prev' =>
array (
0 => 'filesystem.installation.php',
1 => 'Installation',
),
'next' =>
array (
0 => 'filesystem.resources.php',
1 => 'Resource Types',
),
);
$setup["toc"] = $TOC;
$setup["parents"] = $PARENTS;
manual_setup($setup);
manual_header();
?>
<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">
</p><table class="doctable table">
<caption><b>Filesystem and Streams Configuration Options</b></caption>
<thead valign="middle">
<tr valign="middle">
<th>Name</th>
<th>Default</th>
<th>Changeable</th>
<th>Changelog</th>
</tr>
</thead>
<tbody valign="middle" class="tbody">
<tr valign="middle">
<td align="left"><a href="filesystem.configuration.php#ini.allow-url-fopen" class="link">allow_url_fopen</a></td>
<td align="left">"1"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">PHP_INI_ALL in PHP <= 4.3.4. PHP_INI_SYSTEM in PHP < 6. Available since PHP 4.0.4.</td>
</tr>
<tr valign="middle">
<td align="left"><a href="filesystem.configuration.php#ini.allow-url-include" class="link">allow_url_include</a></td>
<td align="left">"0"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">PHP_INI_SYSTEM in PHP 5. Available since PHP 5.2.0.</td>
</tr>
<tr valign="middle">
<td align="left"><a href="filesystem.configuration.php#ini.user-agent" class="link">user_agent</a></td>
<td align="left">NULL</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Available since PHP 4.3.0.</td>
</tr>
<tr valign="middle">
<td align="left"><a href="filesystem.configuration.php#ini.default-socket-timeout" class="link">default_socket_timeout</a></td>
<td align="left">"60"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Available since PHP 4.3.0.</td>
</tr>
<tr valign="middle">
<td align="left"><a href="filesystem.configuration.php#ini.from" class="link">from</a></td>
<td align="left">""</td>
<td align="left">PHP_INI_ALL</td>
<td class="empty"> </td>
</tr>
<tr valign="middle">
<td align="left"><a href="filesystem.configuration.php#ini.auto-detect-line-endings" class="link">auto_detect_line_endings</a></td>
<td align="left">"0"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Available since PHP 4.3.0.</td>
</tr>
</tbody>
</table>
<p>
</p>
<p class="para">Here's a short explanation of
the configuration directives.</p>
<p class="para">
</p><dl>
<dt id="ini.allow-url-fopen" class="varlistentry">
<span class="term">
<i><tt class="parameter">allow_url_fopen</tt></i>
<a href="language.types.boolean.php" class="type boolean">boolean</a>
</span>
</dt><dd class="listitem">
<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>
<blockquote><p><b class="note">Note</b>:
This setting can only be set in php.ini due to security reasons.
<br />
</p></blockquote>
<blockquote><p><b class="note">Note</b>:
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.php#configure.disable-url-fopen-wrapper" class="link"><i><tt class="parameter">
--disable-url-fopen-wrapper</tt></i>
</a>.
<br />
</p></blockquote>
<div class="warning"><b class="warning">Warning</b>
<p class="para">
On Windows versions prior to PHP 4.3.0, the following functions do not
support remote file accessing: <a href="function.include.php" class="function">include()</a>,
<a href="function.include-once.php" class="function">include_once()</a>, <a href="function.require.php" class="function">require()</a>,
<a href="function.require-once.php" class="function">require_once()</a> and the imagecreatefromXXX
functions in the <a href="ref.image.php" class="xref">GD and Image Functions</a> extension.
</p>
</div>
</dd>
<dt id="ini.allow-url-include" class="varlistentry">
<span class="term">
<i><tt class="parameter">allow_url_include</tt></i>
<a href="language.types.boolean.php" class="type boolean">boolean</a>
</span>
</dt><dd class="listitem">
<p class="para">
This option allows the use of URL-aware fopen wrappers with the following
functions: <a href="function.include.php" class="function">include()</a>, <a href="function.include-once.php" class="function">include_once()</a>,
<a href="function.require.php" class="function">require()</a>, <a href="function.require-once.php" class="function">require_once()</a>.
</p>
<blockquote><p><b class="note">Note</b>:
This setting requires allow_url_fopen to be on.
<br />
</p></blockquote>
</dd>
<dt id="ini.user-agent" class="varlistentry">
<span class="term">
<i><tt class="parameter">user_agent</tt></i>
<a href="language.types.string.php" class="type string">string</a>
</span>
</dt><dd class="listitem">
<p class="para">
Define the user agent for PHP to send.
</p>
</dd>
<dt id="ini.default-socket-timeout" class="varlistentry">
<span class="term">
<i><tt class="parameter">default_socket_timeout</tt></i>
<a href="language.types.integer.php" class="type integer">integer</a>
</span>
</dt><dd class="listitem">
<p class="para">
Default timeout (in seconds) for socket based streams.
</p>
<blockquote><p><b class="note">Note</b>:
<span class="simpara">
This configuration option was introduced in PHP 4.3.0
</span>
</p></blockquote>
</dd>
<dt id="ini.from" class="varlistentry">
<span class="term">
<i><tt class="parameter">from</tt></i>
<a href="language.types.string.php" class="type string">string</a>
</span>
</dt><dd class="listitem">
<p class="para">
Define the anonymous ftp password (your email address).
</p>
</dd>
<dt id="ini.auto-detect-line-endings" class="varlistentry">
<span class="term">
<i><tt class="parameter">auto_detect_line_endings</tt></i>
<a href="language.types.boolean.php" class="type boolean">boolean</a>
</span>
</dt><dd class="listitem">
<p class="para">
When turned on, PHP will examine the data read by
<a href="function.fgets.php" class="function">fgets()</a> and <a href="function.file.php" class="function">file()</a> 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><p><b class="note">Note</b>:
<span class="simpara">
This configuration option was introduced in PHP 4.3.0
</span>
</p></blockquote>
</dd>
</dl>
<p>
</p>
</div><?php manual_footer(); ?>
