php-doc-en/reference/info/ini.xml
2012-09-27 15:27:25 +00:00

414 lines
14 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="info.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>PHP Options/Inf 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><link linkend="ini.assert.active">assert.active</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.assert.bail">assert.bail</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.assert.warning">assert.warning</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.assert.callback">assert.callback</link></entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.assert.quiet-eval">assert.quiet_eval</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.enable-dl">enable_dl</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>&removed.php.future;</entry>
</row>
<row>
<entry><link linkend="ini.max-execution-time">max_execution_time</link></entry>
<entry>"30"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.max-input-time">max_input_time</link></entry>
<entry>"-1"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>Available since PHP 4.3.0.</entry>
</row>
<row>
<entry><link linkend="ini.max-input-nesting-level">max_input_nesting_level</link></entry>
<entry>"64"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>Available since PHP 4.4.8 and PHP 5.2.3.</entry>
</row>
<row>
<entry><link linkend="ini.max-input-vars">max_input_vars</link></entry>
<entry>1000</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>Available since PHP 5.3.9.</entry>
</row>
<row>
<entry><link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>PHP_INI_ALL in PHP &lt;= 4.2.3. Removed in PHP 5.4.0.</entry>
</row>
<row>
<entry><link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Removed in PHP 5.4.0.</entry>
</row>
<row>
<entry><link linkend="ini.zend.enable-gc">zend.enable_gc</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since PHP 5.3.0.</entry>
</row>
</tbody>
</tgroup>
</table>
&ini.php.constants;
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.assert.active">
<term>
<parameter>assert.active</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Enable <function>assert</function> evaluation.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.assert.bail">
<term>
<parameter>assert.bail</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Terminate script execution on failed assertions.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.assert.warning">
<term>
<parameter>assert.warning</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Issue a PHP warning for each failed assertion.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.assert.callback">
<term>
<parameter>assert.callback</parameter>
<type>string</type>
</term>
<listitem>
<para>
user function to call on failed assertions
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.assert.quiet-eval">
<term>
<parameter>assert.quiet_eval</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Use the current setting of <function>error_reporting</function> during
assertion expression evaluation. If enabled, no errors are shown
(implicit error_reporting(0)) while evaluation. If disabled, errors are
shown according to the settings of <function>error_reporting</function>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.enable-dl">
<term>
<parameter>enable_dl</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
This directive is really only useful in the Apache module
version of PHP. You can turn dynamic loading of
PHP extensions with <function>dl</function> on and
off per virtual server or per directory.
</para>
<para>
The main reason for turning dynamic loading off is
security. With dynamic loading, it's possible to ignore all
<link linkend="ini.open-basedir">open_basedir</link> restrictions.
The default is to allow dynamic loading, except when using
&safemode;. In &safemode;, it's
always impossible to use <function>dl</function>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.max-execution-time">
<term>
<parameter>max_execution_time</parameter>
<type>integer</type>
</term>
<listitem>
<para>
This sets the maximum time in seconds a script is allowed to
run before it is terminated by the parser. This helps
prevent poorly written scripts from tying up the server. The
default setting is <literal>30</literal>. When running PHP
from the <link linkend="features.commandline">command
line</link> the default setting is <literal>0</literal>.
</para>
<para>
The maximum execution time is not affected by system calls,
stream operations etc. Please see the
<function>set_time_limit</function> function for more
details.
</para>
<para>
You can not change this setting with <function>ini_set</function> when
running in &safemode;. The only workaround is to turn off safe mode or
by changing the time limit in the &php.ini;.
</para>
<para>
Your web server can have other timeout configurations that may
also interrupt PHP execution. Apache has a
<literal>Timeout</literal> directive and IIS has a CGI timeout
function. Both default to 300 seconds. See your web server
documentation for specific details.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.max-input-time">
<term>
<parameter>max_input_time</parameter>
<type>integer</type>
</term>
<listitem>
<para>
This sets the maximum time in seconds a script is allowed to
parse input data, like POST and GET. It is measured from the moment of
receiving all data on the server to the start of script execution.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.max-input-nesting-level">
<term>
<parameter>max_input_nesting_level</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Sets the max nesting depth of
<link linkend="language.variables.external">input variables</link> (i.e.
<varname>$_GET</varname>, <varname>$_POST</varname>..)
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.max-input-vars">
<term>
<parameter>max_input_vars</parameter>
<type>integer</type>
</term>
<listitem>
<para>
How many <link linkend="language.variables.external">input
variables</link> may be accepted (limit is applied to
$_GET, $_POST and $_COOKIE superglobal separately). Use of this directive
mitigates the possibility of denial of service attacks which use hash collisions.
If there are more input variables than specified by this directive,
an <constant>E_WARNING</constant> is issued, and further input
variables are truncated from the request. This limit applies only
to each nesting level of a multi-dimensional input array.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.magic-quotes-gpc">
<term>
<parameter>magic_quotes_gpc</parameter>
<type>boolean</type>
</term>
<listitem>
&warn.deprecated.feature-5-3-0.removed-5-4-0;
<para>
Sets the magic_quotes state for GPC (Get/Post/Cookie)
operations. When magic_quotes are on, all ' (single-quote),
&quot; (double quote), \ (backslash) and NUL's are escaped
with a backslash automatically.
</para>
<note>
<para>
In PHP 4, also <varname>$_ENV</varname>
variables are escaped.
</para>
</note>
<note>
<para>
If the <link linkend="ini.magic-quotes-sybase">
magic_quotes_sybase</link> directive is also ON it will
completely override magic_quotes_gpc. Having both directives
enabled means only single quotes are escaped as
<emphasis>''</emphasis>. Double quotes, backslashes and
NUL's will remain untouched and unescaped.
</para>
</note>
<para>
See also <function>get_magic_quotes_gpc</function>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.magic-quotes-runtime">
<term>
<parameter>magic_quotes_runtime</parameter>
<type>boolean</type>
</term>
<listitem>
&warn.deprecated.feature-5-3-0.removed-5-4-0;
<para>
If <parameter>magic_quotes_runtime</parameter> is enabled,
most functions that return data from any sort of external
source including databases and text files will have quotes
escaped with a backslash. If
<link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>
is also on, a single-quote is escaped with a single-quote instead
of a backslash.
</para>
<para>
Functions affected by <parameter>magic_quotes_runtime</parameter>
(does not include functions from PECL):
<simplelist>
<member><function>get_meta_tags</function></member>
<member><function>file_get_contents</function></member>
<member><function>file</function></member>
<member><function>fgets</function></member>
<member><function>fwrite</function></member>
<member><function>fread</function></member>
<member><function>fputcsv</function></member>
<member><function>stream_socket_recvfrom</function></member>
<member><function>exec</function></member>
<member><function>system</function></member>
<member><function>passthru</function></member>
<member><function>stream_get_contents</function></member>
<member><function>bzread</function></member>
<member><function>gzfile</function></member>
<member><function>gzgets</function></member>
<member><function>gzwrite</function></member>
<member><function>gzread</function></member>
<member><function>exif_read_data</function></member>
<member><function>dba_insert</function></member>
<member><function>dba_replace</function></member>
<member><function>dba_fetch</function></member>
<member><function>ibase_fetch_row</function></member>
<member><function>ibase_fetch_assoc</function></member>
<member><function>ibase_fetch_object</function></member>
<member><function>mssql_fetch_row</function></member>
<member><function>mssql_fetch_object</function></member>
<member><function>mssql_fetch_array</function></member>
<member><function>mssql_fetch_assoc</function></member>
<member><function>mysqli_fetch_row</function></member>
<member><function>mysqli_fetch_array</function></member>
<member><function>mysqli_fetch_assoc</function></member>
<member><function>mysqli_fetch_object</function></member>
<member><function>pg_fetch_row</function></member>
<member><function>pg_fetch_assoc</function></member>
<member><function>pg_fetch_array</function></member>
<member><function>pg_fetch_object</function></member>
<member><function>pg_fetch_all</function></member>
<member><function>pg_select</function></member>
<member><function>sybase_fetch_object</function></member>
<member><function>sybase_fetch_array</function></member>
<member><function>sybase_fetch_assoc</function></member>
<member><function>SplFileObject::fgets</function></member>
<member><function>SplFileObject::fgetcsv</function></member>
<member><function>SplFileObject::fwrite</function></member>
</simplelist>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.zend.enable-gc">
<term>
<parameter>zend.enable_gc</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Enables or disables the circular reference collector.
</para>
</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:"~/.phpdoc/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
-->