php-doc-en/reference/filesystem/ini.xml

186 lines
5 KiB
XML
Raw Normal View History

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.10 $ -->
<section id="filesystem.configuration">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>Filesystem and Streams Configuration Options</title>
<tgroup cols="4">
<thead>
<row>
<entry>Name</entry>
<entry>Default</entry>
<entry>Changeable</entry>
<entry>Changelog</entry>
</row>
</thead>
<tbody>
<row>
<entry>allow_url_fopen</entry>
<entry>"1"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>PHP_INI_ALL in PHP &lt;= 4.3.4. Available since PHP 4.0.4.</entry>
</row>
<row>
<entry>user_agent</entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since PHP 4.3.0.</entry>
</row>
<row>
<entry>default_socket_timeout</entry>
<entry>"60"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since PHP 4.3.0.</entry>
</row>
<row>
<entry>from</entry>
<entry>NULL</entry>
<entry>??</entry>
</row>
<row>
<entry>auto_detect_line_endings</entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since PHP 4.3.0.</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 setting can only be set in php.ini due to security reasons.
</para>
</note>
<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="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 PHP 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
-->