<!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>"1"</td>
<td>PHP_INI_SYSTEM</td>
<td>PHP_INI_ALL in PHP <= 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>"0"</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>"60"</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>""</td>
<td>PHP_INI_ALL</td>
<td class="empty"> </td>
</tr>
<tr>
<td><a href="filesystem.configuration.html#ini.auto-detect-line-endings" class="link">auto_detect_line_endings</a></td>
<td>"0"</td>
<td>PHP_INI_ALL</td>
<td>Available since PHP 4.3.0.</td>
</tr>
</tbody>
</table>
</p>
<p class="para">Here's a short explanation of
the configuration directives.</p>
<p class="para">
<dl>
<dt id="ini.allow-url-fopen">
<span class="term">
<em><code class="parameter">allow_url_fopen</code></em>
<span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
</span>
<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"><em><code class="parameter">
--disable-url-fopen-wrapper</code></em></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>
<dt id="ini.allow-url-include">
<span class="term">
<em><code class="parameter">allow_url_include</code></em>
<span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
</span>
<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>
<dt id="ini.user-agent">
<span class="term">
<em><code class="parameter">user_agent</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
Define the user agent for PHP to send.
</p>
</dd>
</dt>
<dt id="ini.default-socket-timeout">
<span class="term">
<em><code class="parameter">default_socket_timeout</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<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>
<dt id="ini.from">
<span class="term">
<em><code class="parameter">from</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<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>
<dt id="ini.auto-detect-line-endings">
<span class="term">
<em><code class="parameter">auto_detect_line_endings</code></em>
<span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
</span>
<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>
</dt>
</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>
